<ruby id="bdb3f"></ruby>

    <p id="bdb3f"><cite id="bdb3f"></cite></p>

      <p id="bdb3f"><cite id="bdb3f"><th id="bdb3f"></th></cite></p><p id="bdb3f"></p>
        <p id="bdb3f"><cite id="bdb3f"></cite></p>

          <pre id="bdb3f"></pre>
          <pre id="bdb3f"><del id="bdb3f"><thead id="bdb3f"></thead></del></pre>

          <ruby id="bdb3f"><mark id="bdb3f"></mark></ruby><ruby id="bdb3f"></ruby>
          <pre id="bdb3f"><pre id="bdb3f"><mark id="bdb3f"></mark></pre></pre><output id="bdb3f"></output><p id="bdb3f"></p><p id="bdb3f"></p>

          <pre id="bdb3f"><del id="bdb3f"><progress id="bdb3f"></progress></del></pre>

                <ruby id="bdb3f"></ruby>

                ??一站式輕松地調用各大LLM模型接口,支持GPT4、智譜、豆包、星火、月之暗面及文生圖、文生視頻 廣告
                <article><h1>Laravel 的文件系統和云存儲功能集成</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#configuration">配置</a><ul><li><a href="#the-public-disk">公開磁盤</a></li><li><a href="#the-local-driver">本地驅動</a></li><li><a href="#driver-prerequisites">驅動的前置條件</a></li></ul></li><li><a href="#obtaining-disk-instances">獲取磁盤實例</a></li><li><a href="#retrieving-files">提取文件</a><ul><li><a href="#file-urls">文件 URLs</a></li><li><a href="#file-metadata">文件元數據</a></li></ul></li><li><a href="#storing-files">保存文件</a><ul><li><a href="#file-uploads">文件上傳</a></li><li><a href="#file-visibility">文件可見性</a></li></ul></li><li><a href="#deleting-files">刪除文件</a></li><li><a href="#directories">目錄</a></li><li><a href="#custom-filesystems">自定義文件系統</a></li></ul><p><a name="introduction"></a></p><h2><a href="#introduction">簡介</a></h2><p>Laravel 提供強大文件抽象能力,這得益于 Frank de Jonge 的 <a href="https://github.com/thephpleague/flysystem">Flysystem</a> 擴展包。Laravel 集成的 flysystem 提供了可支持本地文件系統、Amazon S3及 Rackspace 云存儲的簡單易用的驅動程序。更棒的是,由于每個系統的API保持不變,所以在這些存儲項之間切換是非常輕松的。</p><p><a name="configuration"></a></p><h2><a href="#configuration">配置</a></h2><p>文件系統配置文件位于 <code class=" language-php">config<span class="token operator">/</span>filesystems<span class="token punctuation">.</span>php</code>。該文件能讓你設置所有的「磁盤(disk)」。每個磁盤代表一個特定的存儲驅動及存儲位置。各種支持驅動的配置示例已包含其中,僅需要簡單的根據你的偏好配置及憑證設置進行修改即可。</p><p>當然,你可隨意配置多組磁盤,即使多個磁盤使用相同的驅動。</p><p><a name="the-public-disk"></a></p><h3>公開磁盤</h3><p>「公開磁盤」就是指你的文件將可被公開訪問,默認下, <code class=" language-php"><span class="token keyword">public</span></code> 磁盤使用 <code class=" language-php">local</code> 驅動且將文件存放在 <code class=" language-php">storage<span class="token operator">/</span>app<span class="token operator">/</span><span class="token keyword">public</span></code> 目錄下。為了能通過網絡訪問,你需要創建 <code class=" language-php"><span class="token keyword">public</span><span class="token operator">/</span>storage</code> 到 <code class=" language-php">storage<span class="token operator">/</span>app<span class="token operator">/</span><span class="token keyword">public</span></code> 的符號鏈接。這個約定能讓你的可公開訪問文件保持在同一個目錄下,這樣在不同的部署系統間就可以輕松共享,如 <a href="https://envoyer.io">Envoyer</a> 的“不停服”部署系統。</p><p>你可以使用 <code class=" language-php">storage<span class="token punctuation">:</span>link</code> Artisan 命令創建符號鏈接:</p><pre class=" language-php"><code class=" language-php">php artisan storage<span class="token punctuation">:</span>link</code></pre><p>當然了,當文件放好且符號鏈接創建完畢后,你就可以用 <code class=" language-php">asset</code> 輔助函數創建 URL 了:</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">echo</span> <span class="token function">asset<span class="token punctuation">(</span></span><span class="token string">'storage/file.txt'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="the-local-driver"></a></p><h3>本地驅動</h3><p>當使用 <code class=" language-php">local</code> 驅動時,所有的操作都是相對于你在配置文件中定義的 <code class=" language-php">root</code> 目錄進行的。該目錄默認是 <code class=" language-php">storage<span class="token operator">/</span>app</code>。所以,下面方法會把文件保存在 <code class=" language-php">storage<span class="token operator">/</span>app<span class="token operator">/</span>file<span class="token punctuation">.</span>txt</code>:</p><pre class=" language-php"><code class=" language-php"><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">disk<span class="token punctuation">(</span></span><span class="token string">'local'</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">put<span class="token punctuation">(</span></span><span class="token string">'file.txt'</span><span class="token punctuation">,</span> <span class="token string">'Contents'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="driver-prerequisites"></a></p><h3>驅動的預先需求</h3><h4>Composer 包</h4><p>在使用 S3 或 Rackspace 驅動之前,你需要通過 Composer 安裝適當擴展包:</p><ul><li>Amazon S3: <code class=" language-php">league<span class="token operator">/</span>flysystem<span class="token operator">-</span>aws<span class="token operator">-</span>s3<span class="token operator">-</span>v3 <span class="token operator">~</span><span class="token number">1.0</span></code></li><li>Rackspace: <code class=" language-php">league<span class="token operator">/</span>flysystem<span class="token operator">-</span>rackspace <span class="token operator">~</span><span class="token number">1.0</span></code></li></ul><h4>S3 驅動配置</h4><p>S3 驅動配置信息位于 <code class=" language-php">config<span class="token operator">/</span>filesystems<span class="token punctuation">.</span>php</code> 配置文件中。 此文件有個關于S3 驅動的配置數組例子。你可根據自己的 S3 配置和憑證修改該數組。</p><h4>FTP 驅動配置</h4><p>Laravel 集成的 Flysystem 能很好的支持 FTP,不過 FTP 的配置示例沒被包含在框架默認的 <code class=" language-php">filesystems<span class="token punctuation">.</span>php</code> 文件中,需要的話照著下面的例子配置:</p><pre class=" language-php"><code class=" language-php"><span class="token string">'ftp'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token punctuation">[</span> <span class="token string">'driver'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'ftp'</span><span class="token punctuation">,</span> <span class="token string">'host'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'ftp.example.com'</span><span class="token punctuation">,</span> <span class="token string">'username'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'your-username'</span><span class="token punctuation">,</span> <span class="token string">'password'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'your-password'</span><span class="token punctuation">,</span> <span class="token comment" spellcheck="true"> // Optional FTP Settings... </span> <span class="token comment" spellcheck="true"> // 'port' =&gt; 21, </span> <span class="token comment" spellcheck="true"> // 'root' =&gt; '', </span> <span class="token comment" spellcheck="true"> // 'passive' =&gt; true, </span> <span class="token comment" spellcheck="true"> // 'ssl' =&gt; true, </span> <span class="token comment" spellcheck="true"> // 'timeout' =&gt; 30, </span><span class="token punctuation">]</span><span class="token punctuation">,</span></code></pre><h4>Rackspace 驅動配置</h4><p>Laravel 集成的 Flysystem 能很好的支持 Rackspace,不過 Rackspace 的配置示例沒被包含在框架默認的 <code class=" language-php">filesystems<span class="token punctuation">.</span>php</code> 文件中,需要的話照著下面的例子配置:</p><pre class=" language-php"><code class=" language-php"><span class="token string">'rackspace'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token punctuation">[</span> <span class="token string">'driver'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'rackspace'</span><span class="token punctuation">,</span> <span class="token string">'username'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'your-username'</span><span class="token punctuation">,</span> <span class="token string">'key'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'your-key'</span><span class="token punctuation">,</span> <span class="token string">'container'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'your-container'</span><span class="token punctuation">,</span> <span class="token string">'endpoint'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'https://identity.api.rackspacecloud.com/v2.0/'</span><span class="token punctuation">,</span> <span class="token string">'region'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'IAD'</span><span class="token punctuation">,</span> <span class="token string">'url_type'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'publicURL'</span><span class="token punctuation">,</span> <span class="token punctuation">]</span><span class="token punctuation">,</span></code></pre><p><a name="obtaining-disk-instances"></a></p><h2><a href="#obtaining-disk-instances">獲得磁盤實例</a></h2><p><code class=" language-php">Storage</code> facade 用于和所有已設置的磁盤交互。例如,你可以調 facade 的 <code class=" language-php">put</code> 方法將一張頭像保存到默認磁盤上。調 <code class=" language-php">Storage</code> facade 的方法前若未先調用 <code class=" language-php">disk</code> 方法,此方法會被自動傳遞給默認磁盤。</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>Facades<span class="token punctuation">\</span>Storage</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">put<span class="token punctuation">(</span></span><span class="token string">'avatars/1'</span><span class="token punctuation">,</span> <span class="token variable">$fileContents</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p>要是你的應用和多個磁盤交互,你可以通過 <code class=" language-php">Storage</code> facade 的 <code class=" language-php">disk</code> 方法訪問特定的磁盤:</p><pre class=" language-php"><code class=" language-php"><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">disk<span class="token punctuation">(</span></span><span class="token string">'s3'</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">put<span class="token punctuation">(</span></span><span class="token string">'avatars/1'</span><span class="token punctuation">,</span> <span class="token variable">$fileContents</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="retrieving-files"></a></p><h2><a href="#retrieving-files">提取文件</a></h2><p><code class=" language-php">get</code> 方法被用作提取文件內容,此方法返回該文件的原始字符串內容。 切記,所有文件路徑都是基于配置文件中 <code class=" language-php">root</code> 目錄的相對路徑。</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$contents</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">get<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><code class=" language-php">exists</code> 方法可以被用于判斷一個文件是否存在于磁盤:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$exists</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">disk<span class="token punctuation">(</span></span><span class="token string">'s3'</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">exists<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="file-urls"></a></p><h3>文件 URLs</h3><p>當使用 <code class=" language-php">local</code> 或者 <code class=" language-php">s3</code> 驅動的時候,你可以使用 <code class=" language-php">url</code> 方法來獲取給定文件的 URL。如果你使用 <code class=" language-php">local</code> 驅動,一般會在傳參的路徑前面加上 <code class=" language-php"><span class="token operator">/</span>storage</code> 且返回相對路徑。如果是 <code class=" language-php">s3</code> 的話,返回的是完整的 S3 文件系統的 URL:</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>Facades<span class="token punctuation">\</span>Storage</span><span class="token punctuation">;</span> <span class="token variable">$url</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">url<span class="token punctuation">(</span></span><span class="token string">'file1.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><blockquote class="has-icon note"><p><div class="flag"><span class="svg"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="90px" height="90px" viewBox="0 0 90 90" enable-background="new 0 0 90 90" xml:space="preserve"><path fill="#FFFFFF" d="M45 0C20.1 0 0 20.1 0 45s20.1 45 45 45 45-20.1 45-45S69.9 0 45 0zM45 74.5c-3.6 0-6.5-2.9-6.5-6.5s2.9-6.5 6.5-6.5 6.5 2.9 6.5 6.5S48.6 74.5 45 74.5zM52.1 23.9l-2.5 29.6c0 2.5-2.1 4.6-4.6 4.6 -2.5 0-4.6-2.1-4.6-4.6l-2.5-29.6c-0.1-0.4-0.1-0.7-0.1-1.1 0-4 3.2-7.2 7.2-7.2 4 0 7.2 3.2 7.2 7.2C52.2 23.1 52.2 23.5 52.1 23.9z"></path></svg></span></div> 切記,如果使用 <code class=" language-php">local</code> 驅動,所有想被公開訪問的文件都應該放在 <code class=" language-php">storage<span class="token operator">/</span>app<span class="token operator">/</span><span class="token keyword">public</span></code> 目錄下。此外,你應該在<code class=" language-php"><span class="token keyword">public</span><span class="token operator">/</span>storage</code> [創建符號鏈接 ] (#the-public-disk) 來指向 <code class=" language-php">storage<span class="token operator">/</span>app<span class="token operator">/</span><span class="token keyword">public</span></code> 文件夾。</p></blockquote><h4>定制本地 URL 主機</h4><p>如果你想給使用 <code class=" language-php">local</code> 驅動的存儲文件預定義主機的話,你可以在磁盤配置數組中添加 <code class=" language-php">url</code> 鍵:</p><pre class=" language-php"><code class=" language-php"><span class="token string">'public'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token punctuation">[</span> <span class="token string">'driver'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'local'</span><span class="token punctuation">,</span> <span class="token string">'root'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token function">storage_path<span class="token punctuation">(</span></span><span class="token string">'app/public'</span><span class="token punctuation">)</span><span class="token punctuation">,</span> <span class="token string">'url'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token function">env<span class="token punctuation">(</span></span><span class="token string">'APP_URL'</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token string">'/storage'</span><span class="token punctuation">,</span> <span class="token string">'visibility'</span> <span class="token operator">=</span><span class="token operator">&gt;</span> <span class="token string">'public'</span><span class="token punctuation">,</span> <span class="token punctuation">]</span><span class="token punctuation">,</span></code></pre><p><a name="file-metadata"></a></p><h3>文件元數據</h3><p>除了讀寫文件,Laravel 還可以提供有關文件本身的信息。例如,<code class=" language-php">size</code> 方法可用來獲取以字節為單位的文件大小:</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>Facades<span class="token punctuation">\</span>Storage</span><span class="token punctuation">;</span> <span class="token variable">$size</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">size<span class="token punctuation">(</span></span><span class="token string">'file1.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><code class=" language-php">lastModified</code> 方法返回的最后一次文件被修改的 UNIX 時間戳:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$time</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">lastModified<span class="token punctuation">(</span></span><span class="token string">'file1.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="storing-files"></a></p><h2><a href="#storing-files">保存文件</a></h2><p><code class=" language-php">put</code> 方法用于保存文件原始內容到一個磁盤上。你也可以傳遞 PHP 的 <code class=" language-php">resource</code> 給 <code class=" language-php">put</code> 方法,它將使用 Flysystem 下的 stream 支持。強烈建議使用 streams 處理大型文件:</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>Facades<span class="token punctuation">\</span>Storage</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">put<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">,</span> <span class="token variable">$contents</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">put<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">,</span> <span class="token variable">$resource</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>自動流</h4><p>如果您想 Laravel 自動管理指定文件流傳輸到您想要的存儲位置,你可以使用 <code class=" language-php">putFile</code> 或 <code class=" language-php">putFileAs</code> 方法。這個方法可以接受一個 <code class=" language-php">Illuminate\<span class="token package">HTTP<span class="token punctuation">\</span>File</span></code> 或 <code class=" language-php">Illuminate\<span class="token package">HTTP<span class="token punctuation">\</span>UploadedFile</span></code> 實例,并自動將文件傳輸到你想要的位置:</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Http<span class="token punctuation">\</span>File</span><span class="token punctuation">;</span> <span class="token comment" spellcheck="true"> // 自動生成唯一文件名... </span><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">putFile<span class="token punctuation">(</span></span><span class="token string">'photos'</span><span class="token punctuation">,</span> <span class="token keyword">new</span> <span class="token class-name">File</span><span class="token punctuation">(</span><span class="token string">'/path/to/photo'</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment" spellcheck="true"> // 手動指定一個文件名... </span><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">putFileAs<span class="token punctuation">(</span></span><span class="token string">'photos'</span><span class="token punctuation">,</span> <span class="token keyword">new</span> <span class="token class-name">File</span><span class="token punctuation">(</span><span class="token string">'/path/to/photo'</span><span class="token punctuation">)</span><span class="token punctuation">,</span> <span class="token string">'photo.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p>關于 <code class=" language-php">putFile</code> 方法有些重要的提醒。我們只指定一個目錄名,而非文件名。默認情況下,該 <code class=" language-php">putFile</code> 方法將生成以為唯一ID作為文件名。文件的路徑將被 <code class=" language-php">putFile</code> 方法返回,因此您可以在數據庫中存儲路徑及文件名。</p><p><code class=" language-php">putFile</code> 和 <code class=" language-php">putFileAs</code> 方法也接受一個參數指定被存儲文件的「可見性」。在使用如 S3 的云存儲時,若希望該文件可被公開訪問,這將非常有用:</p><pre class=" language-php"><code class=" language-php"><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">putFile<span class="token punctuation">(</span></span><span class="token string">'photos'</span><span class="token punctuation">,</span> <span class="token keyword">new</span> <span class="token class-name">File</span><span class="token punctuation">(</span><span class="token string">'/path/to/photo'</span><span class="token punctuation">)</span><span class="token punctuation">,</span> <span class="token string">'public'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>插入到文件</h4><p><code class=" language-php">prepend</code> 及 <code class=" language-php">append</code> 方法允許你將內容寫入到一個文件的開頭或結尾:</p><pre class=" language-php"><code class=" language-php"><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">prepend<span class="token punctuation">(</span></span><span class="token string">'file.log'</span><span class="token punctuation">,</span> <span class="token string">'Prepended Text'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">append<span class="token punctuation">(</span></span><span class="token string">'file.log'</span><span class="token punctuation">,</span> <span class="token string">'Appended Text'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>復制 &amp; 移動文件</h4><p><code class=" language-php">copy</code> 方法用于復制一個已存在的文件到磁盤的新位置。<code class=" language-php">move</code> 方法用于重命名或是移動一個已存在的文件到新位置:</p><pre class=" language-php"><code class=" language-php"><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">copy<span class="token punctuation">(</span></span><span class="token string">'old/file1.jpg'</span><span class="token punctuation">,</span> <span class="token string">'new/file1.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">move<span class="token punctuation">(</span></span><span class="token string">'old/file1.jpg'</span><span class="token punctuation">,</span> <span class="token string">'new/file1.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="file-uploads"></a></p><h3>文件上傳</h3><p>在 Web 應用中,存儲文件最常見的例子之一就是存儲用戶上傳的文件,如個人資料圖片,照片和文檔。 Laravel 通過使用文件上傳實例的 <code class=" language-php">store</code> 方法,使其可以非常容易的存儲上傳的文件。只需使用你想存儲的路徑來調用 <code class=" language-php">store</code> 方法即可:</p><pre class=" language-php"><code class=" language-php"><span class="token delimiter">&lt;?php</span> <span class="token keyword">namespace</span> <span class="token package">App<span class="token punctuation">\</span>Http<span class="token punctuation">\</span>Controllers</span><span class="token punctuation">;</span> <span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Http<span class="token punctuation">\</span>Request</span><span class="token punctuation">;</span> <span class="token keyword">use</span> <span class="token package">App<span class="token punctuation">\</span>Http<span class="token punctuation">\</span>Controllers<span class="token punctuation">\</span>Controller</span><span class="token punctuation">;</span> <span class="token keyword">class</span> <span class="token class-name">UserAvatarController</span> <span class="token keyword">extends</span> <span class="token class-name">Controller</span> <span class="token punctuation">{</span> <span class="token comment" spellcheck="true">/** * 更新用戶頭像。 * * @param Request $request * @return Response */</span> <span class="token keyword">public</span> <span class="token keyword">function</span> <span class="token function">update<span class="token punctuation">(</span></span>Request <span class="token variable">$request</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token variable">$path</span> <span class="token operator">=</span> <span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">file<span class="token punctuation">(</span></span><span class="token string">'avatar'</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">store<span class="token punctuation">(</span></span><span class="token string">'avatars'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> <span class="token variable">$path</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span></code></pre><p>關于此例有些注意事項。我們只指定一個目錄名,而不是文件名。默認情況下,<code class=" language-php">store</code> 方法將生成唯一ID來作為文件名。此文件路徑將被 <code class=" language-php">store</code> 方法返回,因此你可以在數據庫中存儲路徑及文件名。</p><p>你也可以調用<code class=" language-php">Storage</code> facade 的 <code class=" language-php">putFile</code> 方法來執行和上面例子相同的文件操作:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$path</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">putFile<span class="token punctuation">(</span></span><span class="token string">'avatars'</span><span class="token punctuation">,</span> <span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">file<span class="token punctuation">(</span></span><span class="token string">'avatar'</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>指定文件名</h4><p>如果你不喜歡自動生成的文件名,你可以使用 <code class=" language-php">storeAs</code> 方法,它接收的路徑、文件名、磁盤(可選的)作為它的參數:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$path</span> <span class="token operator">=</span> <span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">file<span class="token punctuation">(</span></span><span class="token string">'avatar'</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">storeAs<span class="token punctuation">(</span></span> <span class="token string">'avatars'</span><span class="token punctuation">,</span> <span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">user<span class="token punctuation">(</span></span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token property">id</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p>當然,你也可以使用 <code class=" language-php">Storage</code> facade 的 <code class=" language-php">putFileAs</code> 方法,可以和上面例子的文件操作有相同效果:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$path</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">putFileAs<span class="token punctuation">(</span></span> <span class="token string">'avatars'</span><span class="token punctuation">,</span> <span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">file<span class="token punctuation">(</span></span><span class="token string">'avatar'</span><span class="token punctuation">)</span><span class="token punctuation">,</span> <span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">user<span class="token punctuation">(</span></span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token property">id</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>指定磁盤</h4><p>默認情況下,此方法將使用默認的磁盤。如果你想指定其他磁盤,給<code class=" language-php">store</code> 方法的第二個參數傳磁盤名:</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$path</span> <span class="token operator">=</span> <span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">file<span class="token punctuation">(</span></span><span class="token string">'avatar'</span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">store<span class="token punctuation">(</span></span> <span class="token string">'avatars/'</span><span class="token punctuation">.</span><span class="token variable">$request</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token function">user<span class="token punctuation">(</span></span><span class="token punctuation">)</span><span class="token operator">-</span><span class="token operator">&gt;</span><span class="token property">id</span><span class="token punctuation">,</span> <span class="token string">'s3'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="file-visibility"></a></p><h3>文件可見性</h3><p>在 Laravel 的 Flysystem 集成里,「可見性」 是跨多平臺的文件權限抽象。文件可以被設定為 <code class=" language-php"><span class="token keyword">public</span></code> 或 <code class=" language-php"><span class="token keyword">private</span></code> 。當一個文件聲明為 <code class=" language-php"><span class="token keyword">public</span></code> 時,就意味著文件一般可供他人訪問。例如,使用S3驅動時,你可檢索 <code class=" language-php"><span class="token keyword">public</span></code> 文件的URL。</p><p>你可通過 <code class=" language-php">put</code> 方法設定文件可見性:</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>Facades<span class="token punctuation">\</span>Storage</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">put<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">,</span> <span class="token variable">$contents</span><span class="token punctuation">,</span> <span class="token string">'public'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p>如果文件已經被保存,其可見性可以通過 <code class=" language-php">getVisibility</code> 來獲取和 <code class=" language-php">setVisibility</code> 方法來設置。</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$visibility</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">getVisibility<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">setVisibility<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">,</span> <span class="token string">'public'</span><span class="token punctuation">)</span></code></pre><p><a name="deleting-files"></a></p><h2><a href="#deleting-files">刪除文件</a></h2><p><code class=" language-php">delete</code> 方法接受一個文件名稱或文件數組,用于從磁盤移除文件:</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>Facades<span class="token punctuation">\</span>Storage</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">delete<span class="token punctuation">(</span></span><span class="token string">'file.jpg'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">delete<span class="token punctuation">(</span></span><span class="token punctuation">[</span><span class="token string">'file1.jpg'</span><span class="token punctuation">,</span> <span class="token string">'file2.jpg'</span><span class="token punctuation">]</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="directories"></a></p><h2><a href="#directories">目錄</a></h2><h4>獲取某目錄內的所有文件</h4><p><code class=" language-php">files</code> 方法返回指定目錄下的所有文件數組。如果你還想獲取指定目錄下子目錄的文件,可以使用 <code class=" language-php">allFiles</code> 方法。</p><pre class=" language-php"><code class=" language-php"><span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>Facades<span class="token punctuation">\</span>Storage</span><span class="token punctuation">;</span> <span class="token variable">$files</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">files<span class="token punctuation">(</span></span><span class="token variable">$directory</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token variable">$files</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">allFiles<span class="token punctuation">(</span></span><span class="token variable">$directory</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>獲取單個目錄內所有目錄</h4><p><code class=" language-php">directories</code> 方法返回指定目錄下的目錄數組。另外,你也可以使用 <code class=" language-php">allDirectories</code> 方法獲取指定目錄下的子目錄以及子目錄所包含的目錄。</p><pre class=" language-php"><code class=" language-php"><span class="token variable">$directories</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">directories<span class="token punctuation">(</span></span><span class="token variable">$directory</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment" spellcheck="true"> // 遞歸... </span><span class="token variable">$directories</span> <span class="token operator">=</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">allDirectories<span class="token punctuation">(</span></span><span class="token variable">$directory</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>創建目錄</h4><p><code class=" language-php">makeDirectory</code> 方法將創建指定的目錄,包括任何所需的子目錄。</p><pre class=" language-php"><code class=" language-php"><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">makeDirectory<span class="token punctuation">(</span></span><span class="token variable">$directory</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h4>刪除目錄</h4><p>最后,<code class=" language-php">deleteDirectory</code> 方法刪除目錄及所包含的全部文件。</p><pre class=" language-php"><code class=" language-php"><span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">deleteDirectory<span class="token punctuation">(</span></span><span class="token variable">$directory</span><span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><a name="custom-filesystems"></a></p><h2><a href="#custom-filesystems">自定義文件系統</a></h2><p>Laravel 的 Flysystem 集成提供一系列開箱即用的驅動支持;然而 Flysystem 不僅限于此,還擁有其它存儲系統適配器。如果在你的 Laravel 的應用中想使用額外的存儲適配器,你可以創建自定義驅動。</p><p>為了建構一個自定義的文件系統,你需要創建一個如 <code class=" language-php">DropboxServiceProvider</code> 的 <a href="/docs/5.4/providers">服務提供者</a>。并在該提供者的 <code class=" language-php">boot</code> 方法使用 <code class=" language-php">Storage</code> facade 的 <code class=" language-php">extend</code> 方法自定義你的驅動。</p><pre class=" language-php"><code class=" language-php"><span class="token delimiter">&lt;?php</span> <span class="token keyword">namespace</span> <span class="token package">App<span class="token punctuation">\</span>Providers</span><span class="token punctuation">;</span> <span class="token keyword">use</span> <span class="token package">Storage</span><span class="token punctuation">;</span> <span class="token keyword">use</span> <span class="token package">League<span class="token punctuation">\</span>Flysystem<span class="token punctuation">\</span>Filesystem</span><span class="token punctuation">;</span> <span class="token keyword">use</span> <span class="token package">Dropbox<span class="token punctuation">\</span>Client</span> <span class="token keyword">as</span> DropboxClient<span class="token punctuation">;</span> <span class="token keyword">use</span> <span class="token package">Illuminate<span class="token punctuation">\</span>Support<span class="token punctuation">\</span>ServiceProvider</span><span class="token punctuation">;</span> <span class="token keyword">use</span> <span class="token package">League<span class="token punctuation">\</span>Flysystem<span class="token punctuation">\</span>Dropbox<span class="token punctuation">\</span>DropboxAdapter</span><span class="token punctuation">;</span> <span class="token keyword">class</span> <span class="token class-name">DropboxServiceProvider</span> <span class="token keyword">extends</span> <span class="token class-name">ServiceProvider</span> <span class="token punctuation">{</span> <span class="token comment" spellcheck="true">/** * 運行服務注冊后的啟動進程。 * * @return void */</span> <span class="token keyword">public</span> <span class="token keyword">function</span> <span class="token function">boot<span class="token punctuation">(</span></span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token scope">Storage<span class="token punctuation">::</span></span><span class="token function">extend<span class="token punctuation">(</span></span><span class="token string">'dropbox'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span><span class="token variable">$app</span><span class="token punctuation">,</span> <span class="token variable">$config</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token variable">$client</span> <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">DropboxClient</span><span class="token punctuation">(</span> <span class="token variable">$config</span><span class="token punctuation">[</span><span class="token string">'accessToken'</span><span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token variable">$config</span><span class="token punctuation">[</span><span class="token string">'clientIdentifier'</span><span class="token punctuation">]</span> <span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> <span class="token keyword">new</span> <span class="token class-name">Filesystem</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">DropboxAdapter</span><span class="token punctuation">(</span><span class="token variable">$client</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token comment" spellcheck="true">/** * 在容器注冊綁定。 * * @return void */</span> <span class="token keyword">public</span> <span class="token keyword">function</span> <span class="token function">register<span class="token punctuation">(</span></span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token comment" spellcheck="true"> // </span> <span class="token punctuation">}</span> <span class="token punctuation">}</span></code></pre><p><code class=" language-php">extend</code> 方法的第一個參數是驅動名,第二個參數則是一個接受 <code class=" language-php"><span class="token variable">$app</span></code> 及 <code class=" language-php"><span class="token variable">$config</span></code> 變量的閉包。該閉包必須返回 <code class=" language-php">League\<span class="token package">Flysystem<span class="token punctuation">\</span>Filesystem</span></code> 的實例。<code class=" language-php"><span class="token variable">$config</span></code> 變量包含了在 <code class=" language-php">config<span class="token operator">/</span>filesystems<span class="token punctuation">.</span>php</code> 定義的特定磁盤配置。</p><p>一旦通過創建服務提供者注冊此擴展后,你就可以在 <code class=" language-php">config<span class="token operator">/</span>filesystem<span class="token punctuation">.</span>php</code> 配置文件中使用 <code class=" language-php">dropbox</code> 驅動。</p><h2>譯者署名</h2><table><thead><tr><th>用戶名</th><th>頭像</th><th>職能</th><th>簽名</th></tr></thead><tbody><tr><td><a href="https://github.com/zuoRambo">@Rambone</a></td><td><img class="avatar-66 rm-style" src="http://tva1.sinaimg.cn/crop.0.0.1002.1002.180/92d03bcdjw8f0asasf3m1j20ru0rvaeo.jpg"></td><td>譯者</td><td>php,go求職 簡歷請發zuoxiaojie@lianjia.com</td></tr></tbody></table></article>
                  <ruby id="bdb3f"></ruby>

                  <p id="bdb3f"><cite id="bdb3f"></cite></p>

                    <p id="bdb3f"><cite id="bdb3f"><th id="bdb3f"></th></cite></p><p id="bdb3f"></p>
                      <p id="bdb3f"><cite id="bdb3f"></cite></p>

                        <pre id="bdb3f"></pre>
                        <pre id="bdb3f"><del id="bdb3f"><thead id="bdb3f"></thead></del></pre>

                        <ruby id="bdb3f"><mark id="bdb3f"></mark></ruby><ruby id="bdb3f"></ruby>
                        <pre id="bdb3f"><pre id="bdb3f"><mark id="bdb3f"></mark></pre></pre><output id="bdb3f"></output><p id="bdb3f"></p><p id="bdb3f"></p>

                        <pre id="bdb3f"><del id="bdb3f"><progress id="bdb3f"></progress></del></pre>

                              <ruby id="bdb3f"></ruby>

                              哎呀哎呀视频在线观看