# 媒體 默認情況下，介質管理器使用安裝目錄的storage / app / media子目錄。要使用Amazon S3或Rackspace CDN，您應該更新系統配置。 > 您需要先安裝[Drivers插件，](http://www.hmoore.net/followme/octobercms/1073836#3)然后才能使用Amazon S3或Rackspace CDN功能。 請注意，更改介質管理器配置后，應重置其緩存。您可以按“媒體管理器”工具欄中的“\*\*刷新”\*\*按鈕來執行此操作。 ## **配置Amazon S3訪問** 要將Amazon S3與OctoberCMS一起使用，您應該在存儲桶和API用戶中創建S3存儲桶，文件夾。 注冊Amazon AWS賬戶或使用現有帳戶登錄AWS Console。打開S3管理面板。創建一個新存儲桶并為其分配任何名稱（存儲桶的名稱將是您的公共文件URL的一部分）。 在存儲桶中創建**媒體**文件夾。文件夾名稱無關緊要。此文件夾將是媒體庫的根目錄。 默認情況下，無法直接訪問S3存儲桶中的文件。要使存儲桶處于公共狀態，請返回存儲桶列表并單擊存儲桶。單擊右側邊欄中的**屬性**按鈕。展開**權限**選項卡。單擊**編輯存儲桶策略**鏈接。將以下代碼粘貼到策略彈出窗口。將桶名稱替換為您的實際存儲桶名稱： ``` { "Version": "2008-10-17", "Id": "Policy1397632521960", "Statement": [ { "Sid": "Stmt1397633323327", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKETNAME/*" } ] } ``` 單擊**保存**按鈕以應用策略。該策略提供對存儲桶中所有文件夾和目錄的公共只讀訪問權限。如果您打算將存儲桶用于其他需求，則可以設置對存儲桶中特定文件夾的公共訪問權限，只需在**資源**值中指定目錄名稱： ``` "arn:aws:s3:::BUCKETNAME/media/*" ``` 您還應該創建一個API用戶，OctoberCMS將使用該用戶來管理存儲桶文件。在AWS控制臺中，轉到IAM部分。轉到“用戶”選項卡并創建新用戶。用戶名無關緊要。確保在創建新用戶時選中“為每個用戶生成訪問密鑰”復選框。AWS創建用戶后，它允許您查看安全憑證 - 用戶**訪問密鑰ID**和**秘密訪問密鑰**。復制密鑰并將其放入臨時文本文件中。 返回用戶列表，然后單擊剛剛創建的用戶。在**權限**部分中，單擊**附加策略**按鈕。在列表中選擇**AmazonS3FullAccess**策略，然后單擊**Attach Policy**按鈕。 現在您擁有更新OctoberCMS配置的所有信息。打開**config / filesystem.php**腳本并找到**磁盤**部分。它已包含s3配置，您需要替換API憑據和存儲桶信息參數： | 參數 | 值 | |-- |-- | | **key** | 您之前創建的用戶的**訪問密鑰ID**值。 | | **secret** | 您創建的用戶的**秘密訪問密鑰**值。 | | **bucket** | 你的桶名。 | | **region** | 桶區域代碼，見下文。 | 您可以在存儲區屬性中的S3管理控制臺中找到存儲區域。“屬性”選項卡顯示區域名稱，例如Oregon。S3驅動程序配置需要存儲桶代碼。使用此表查找存儲桶的代碼（您還可以查看[AWS文檔](http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)）： | 區域 | 碼 | |--- |---- | | **美國標準** | us-east-1 | | **美國西部（俄勒岡州）** | us-west-2 | | **美國西部（加利福尼亞州北部）** | us-west-1 | | **歐盟（愛爾蘭）** | eu-west-1 | | **EU（法蘭克福）** | eu-central-1 | | **亞太地區（新加坡）** | ap-southeast-1 | | **亞太地區（悉尼）** | ap-southeast-2 | | **亞太（東京）** | ap-northeast-1 | | **南美洲（圣保羅）** | sa-east-1 | 更新后的配置示例： ``` 'disks' => [ ... 's3' => [ 'driver' => 's3', 'key' => 'XXXXXXXXXXXXXXXXXXXX', 'secret' => 'xxxXxXX+XxxxxXXxXxxxxxxXxxXXXXXXXxxxX9Xx', 'region' => 'us-west-2', 'bucket' => 'my-bucket' ], ... ] ``` 保存**config / filesystem.php**腳本并打開**config / cms.php**腳本。找到部分**存儲**。在**media**參數更新**磁盤**，**文件夾**和**路徑**參數中： 參數值**disk**使用**s3**值。**folder**您在S3存儲桶中創建的文件夾的名稱。**path**存儲桶中文件夾的公共路徑，請參見下文。要獲取文件夾的路徑，請打開AWS控制臺并轉到S3部分。導航到存儲桶，然后單擊您之前創建的文件夾。將任何文件上傳到該文件夾，然后單擊該文件。單擊右側邊欄中的“**屬性”**按鈕。文件URL位于**Link**參數中。復制URL并從中刪除文件名和尾部斜杠。 示例存儲配置： ``` 'storage' => [ ... 'media' => [ 'disk' => 's3', 'folder' => 'media', 'path' => 'https://s3-us-west-2.amazonaws.com/your-bucket-name/media' ] ] ``` 恭喜！現在，您已準備好將Amazon S3與OctoberCMS配合使用。請注意，您還可以配置Amazon CloudFront CDN以使用您的存儲桶。本主題未在本文檔中介紹，請參閱[CloudFront文檔](http://www.hmoore.net/followme/octobercms/1073836#3)。配置CloudFront后，您需要更新存儲配置中的**path**參數。 ## **配置Rackspace CDN訪問** 要將Rackspace CDN與OctoberCMS一起使用，您應該在容器和API用戶中創建Rackspace CDN容器，文件夾。 登錄Rackspace管理控制臺并導航到Storage / Files頁面。創建一個新容器。容器名稱無關緊要，它將成為公共文件URL的一部分。為新容器選擇\*\*公共（啟用CDN）\*\*類型。 在容器中創建**媒體**文件夾。文件夾名稱無關緊要。此文件夾將是媒體庫的根目錄。 您應該創建一個API用戶，OctoberCMS將使用該用戶來管理CDN容器中的文件。在Rackspace控制臺中打開帳戶/用戶管理頁面。單擊**創建用戶**按鈕。填寫用戶名（例如october.cdn.api），密碼，安全問題和答案。在**Product Access**部分中，選擇**Custom，**然后在CDN行中選擇**Admin**。在“\*\*帳戶”\*\*部分中使用“**無訪問權”**角色，并在“**聯系信息”**部分中使用**技術聯系**人類保存用戶帳戶。保存帳戶后，您將看到帶有**API密鑰**的“登錄詳細信息”部分包含您需要在OctoberCMS配置文件中使用的值的行。 現在您擁有更新OctoberCMS配置的所有信息。打開**config / filesystem.php**腳本并找到**磁盤**部分。它已包含Rackspace配置，您需要替換API憑據和容器信息參數： 參數值**username**Rackspace用戶名（例如october.cdn.api）。**key**您可以從Rackspace用戶個人資料頁面復制的用戶**API密鑰**。**container**容器名稱。**region**桶區域代碼，見下文。**endpoint**保持原樣。**region**您可以在Rackspace控制面板的CDN容器列表中找到該區域。代碼是一個3個字母的值，例如它是芝加哥的**ORD**。更新后的配置示例： ``` 'disks' => [ ... 'rackspace' => [ 'driver' => 'rackspace', 'username' => 'october.api.cdn', 'key' => 'xx00000000xxxxxx0x0x0x000xx0x0x0', 'container' => 'my-bucket', 'endpoint' => 'https://identity.api.rackspacecloud.com/v2.0/', 'region' => 'ORD' ], ... ] ``` 保存**config / filesystem.php**腳本并打開**config / cms.php**腳本。找到部分**存儲**。在**media**參數更新**磁盤**，**文件夾**和**路徑**參數中： 參數值**disk**使用**rackspace**值。**folder**您在CDN容器中創建的文件夾的名稱。**path**容器中文件夾的公共路徑，請參見下文。要獲取文件夾的路徑，請轉至Rackspace控制臺中的CDN容器列表。單擊容器并打開媒體文件夾。上傳任何文件。上傳文件后，單擊它。該文件將在新的瀏覽器選項卡中打開。復制文件URL并從中刪除文件名和尾隨斜杠。 示例存儲配置： ``` 'storage' => [ ... 'media' => [ 'disk' => 'rackspace', 'folder' => 'media', 'path' => 'https://xxxxxxxxx-xxxxxxxxx.r00.cf0.rackcdn.com/media' ] ] ``` 恭喜！現在您已準備好將Rackspace CDN與OctoberCMS一起使用。 ## **音頻和視頻播放器** 默認情況下，系統使用HTML5音頻和視頻標簽來呈現音頻和視頻文件： ``` <video src="video.mp4" controls></video> ``` 要么 ``` <audio src="audio.mp3" controls></audio> ``` 可以覆蓋此行為。如果有**oc-audio-player.html**和**oc-video-player.html**CMS部分，它們將用于顯示音頻和視頻內容。在partials內部使用變量**src**輸出到源文件的鏈接。例： ``` <video src="{{ src }}" width="320" height="200" controls preload></video> ``` 如果您不想使用HTML5播放器，則可以在部分中提供任何其他標記。有一個[第三方腳本](https://html5media.info/)可以支持舊版瀏覽器中的HTML5視頻和音頻標簽。 由于部分是使用Twig編寫的，因此您可以根據命名約定自動添加備用視頻源。例如，如果有一個約定，每個全分辨率視頻的分辨率視頻總是較小，而較小分辨率的文件擴展名為“iphone.mp4”，則生成的標記可能如下所示： ``` <video controls> <source src="{{ src }}" media="only screen and (min-device-width: 568px)"></source> <source src="{{ src|replace({'.mp4': '.iphone.mp4'}) }}" media="only screen and (max-device-width: 568px)"></source> </video> ``` ## **其他配置選項** 有幾個選項可以讓您微調媒體管理器。所有這些都可以在**config / cms.php**腳本中的**存儲/媒體**部分中定義，例如： ``` 'storage' => [ ... 'media' => [ ... 'ignore' => ['.svn', '.git', '.DS_Store'] ] ], ``` 參數值**ignore**要忽略的文件和目錄名稱列表。默認為\['.svn'，'。git'，'。DS\_Store'\]。**ttl**指定緩存生存時間，以分鐘為單位。默認值為10.添加，更新或刪除庫項目時，緩存會自動失效。**imageExtensions**與Image文檔類型對應的文件擴展名。默認值為\*\*\['gif'，'png'，'jpg'，'jpeg'，'bmp'\]\*\*。**videoExtensions**與視頻文檔類型對應的文件擴展名。默認值為\*\*\['mp4'，'avi'，'mov'，'mpg'\]\*\*。**audioExtensions**與音頻文檔類型對應的文件擴展名。默認值為\*\*\['mp3'，'wav'，'wma'，'m4a'\]\*\*。## **事件** 媒體管理器提供了一些您可以監聽的[事件](http://www.hmoore.net/followme/octobercms/1073836#3)，以提高可擴展性。 事件描述參數**folder.delete**刪除文件夾時調用`(string) $path`**file.delete**刪除文件時調用`(string) $path`**folder.rename**重命名文件夾時調用`(string) $originalPath`，`(string) $newPath`**file.rename**重命名文件時調用`(string) $originalPath`，`(string) $newPath`**folder.create**創建文件夾時調用`(string) $newFolderPath`**folder.move**移動文件夾時調用`(string) $path`，`(string) $dest`**file.move**移動文件時調用`(string) $path`，`(string) $dest`**file.upload**上傳文件時調用`(string) $filePath`，`(\Symfony\Component\HttpFoundation\File\UploadedFile) $uploadedFile`**要掛鉤這些事件，可以`Backend\Widgets\MediaManager`直接擴展類：** ``` Backend\Widgets\MediaManager::extend(function($widget) { $widget->bindEvent('file.rename', function ($originalPath, $newPath) { // Update custom references to path here }); }); ``` **或者通過`Event`Facade全局監聽（每個事件都以前綴為例，`media.`并將實例化`Backend\Widgets\MediaManager`對象作為第一個參數傳遞）：** ``` Event::listen('media.file.rename', function($widget, $originalPath, $newPath) { // Update custom references to path here }); ``` ## **故障排除** 使用遠程服務的最常見問題是SSL連接問題。如果您收到SSL錯誤，請確保您的服務器具有公共證書頒發機構（CA）的新SSL證書。