文件與圖片

產生 TXT、JSON 與 CSV 文件

產生 UTF-8 TXT 文件：

php

$file = FileMagic::text("第一行\n第二行")
    ->onDisk('local')
    ->inDirectory('documents')
    ->named('notes')
    ->store();

text() 會完整保留輸入內容，包括空白與換行。空字串會產生空的 .txt 檔案。

從 array 或 JsonSerializable 物件產生容易閱讀的 JSON：

php

$file = FileMagic::json([
    'message' => '我是文字',
    'items' => ['第一筆', '第二筆'],
])
    ->named('messages')
    ->store();

JSON 使用 pretty print、保留 Unicode 與未跳脫的 slash，並在文件結尾加入換行。

產生 CSV 文件：

php

$file = FileMagic::csv([
    ['name' => '第一筆', 'content' => '我是文字'],
    ['name' => '第二筆', 'content' => '我是文字 2'],
])
    ->named('messages')
    ->store();

Associative rows 會使用第一列的 key 自動產生 header；list rows 不會產生 header。每列必須使用相同的 key 與順序，每個值必須是 scalar 或 null。CSV 固定使用不含 BOM 的 UTF-8、逗號 delimiter、雙引號 enclosure 與 CRLF 行尾。

csv() 會立即走訪 iterable，並在回傳 PendingFile 前把產生的完整輸出放入 PHP 記憶體。 CSV 沒有獨立的輸出上限，之後設定 maxSize() 也無法限制產生 CSV 時的記憶體用量。大型匯出請先由應用程式串流寫入本機檔案，再用 fromPath() 儲存。

三個方法都會回傳 PendingFile，因此仍可使用 disk、directory、filename、visibility、 collision、owner、metadata、MIME 與 size 設定。呼叫 store() 後會取得一般的 StoredFile，也能使用所有 FileQuery 操作。

無效 UTF-8、無法編碼的 JSON 值，以及結構不一致的 CSV rows 會拋出 InvalidDocumentData。

圖片縮放

先安裝 optional dependency：

bash

composer require "intervention/image:^4.0"

確認 GD 或 Imagick 已啟用後，即可按比例縮放：

php

$file = FileMagic::fromUpload($image)
    ->resizeImage(maxWidth: 1600, quality: 82)
    ->store();

使用設定檔的預設尺寸及品質：

php

$file = FileMagic::fromUpload($image)
    ->resizeImage()
    ->store();

支援 JPEG、PNG、WebP 與 BMP，實際可處理的格式取決於 driver。縮放會維持比例、只縮小不放大；同時安裝 Imagick 與 GD 時會優先使用 Imagick。

resizeImage() 會盡可能處理圖片。非圖片、GIF、SVG、不支援的格式，以及已知的解碼或編碼失敗，都會保留原始內容。因此，不能用這個方法驗證上傳內容一定是合法圖片。

最大寬度必須是正整數，品質必須介於 1 至 100，即使來源不是圖片也會驗證。處理支援格式時若缺少 Intervention Image 或可用的 driver，會拋出 ImageProcessingUnavailable；未預期的系統錯誤也不會被忽略。

FileMagic 會在圖片解碼或縮放前先對原始來源套用 size 與 MIME 限制；輸出有變更時，也會在儲存前再次檢查最終內容。原始圖片超過 maxSize() 時，即使縮放後可能變小，仍會被拒絕。

文件與圖片 ​

產生 TXT、JSON 與 CSV 文件 ​

圖片縮放 ​

文件與圖片

產生 TXT、JSON 與 CSV 文件

圖片縮放