{"id":3188,"date":"2024-12-12T08:43:05","date_gmt":"2024-12-12T11:43:05","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=3188"},"modified":"2025-12-07T12:50:31","modified_gmt":"2025-12-07T15:50:31","slug":"armazenamento-de-arquivos-laravel-s3","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/armazenamento-de-arquivos-laravel-s3\/","title":{"rendered":"Armazenamento de Arquivos com Laravel S3"},"content":{"rendered":"Tempo de leitura: <\/span> 4<\/span> minutos<\/span><\/span>\n

Armazenamento de Arquivos com Laravel S3<\/strong>: O Laravel Filesystem<\/strong> oferece uma API unificada e fluida para interagir com diversos sistemas de arquivos (ou Drivers<\/strong>), gra\u00e7as ao componente Flysystem<\/strong> do PHP. Essa abstra\u00e7\u00e3o permite que voc\u00ea utilize o mesmo c\u00f3digo para armazenar arquivos em um servidor local, em ambientes de teste, ou em servi\u00e7os de cloud<\/em> como o Amazon S3<\/strong> (Simple Storage Service).<\/p>\n\n\n\n

O uso do Laravel S3 \u00e9 fundamental para aplica\u00e7\u00f5es escal\u00e1veis, que exigem durabilidade, alta disponibilidade e distribui\u00e7\u00e3o de conte\u00fado.<\/p>\n\n\n\n

<\/div>\n\n\n\n

1. \u2699\ufe0f Configura\u00e7\u00e3o dos Discos de Armazenamento<\/h2>\n\n\n\n

A configura\u00e7\u00e3o de todos os destinos de armazenamento \u00e9 centralizada no arquivo config\/filesystems.php<\/code><\/strong>. Cada destino \u00e9 chamado de Disco<\/strong> (Disk<\/em>).<\/p>\n\n\n\n

<\/div>\n\n\n\n

A. Drivers Comuns<\/h3>\n\n\n\n
Disco<\/strong><\/td>Driver<\/strong><\/td>Uso<\/strong><\/td><\/tr><\/thead>
local<\/code><\/strong><\/td>local<\/code><\/td>Armazena arquivos diretamente no sistema de arquivos do servidor.<\/td><\/tr>
public<\/code><\/strong><\/td>local<\/code><\/td>Semelhante ao local<\/code>, mas destinado a arquivos acess\u00edveis publicamente (requer symlink<\/em>).<\/td><\/tr>
s3<\/code><\/strong><\/td>s3<\/code><\/td>Usa o Amazon S3<\/strong> ou servi\u00e7os compat\u00edveis (como DigitalOcean Spaces).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

B. Configura\u00e7\u00e3o do Disco S3<\/h3>\n\n\n\n

Para usar o S3, voc\u00ea deve garantir que o pacote AWS SDK for PHP esteja instalado (composer require league\/flysystem-aws-s3-v3<\/code>) e configurar as credenciais no arquivo config\/filesystems.php<\/code> usando vari\u00e1veis de ambiente.<\/p>\n\n\n\n

PHP<\/p>\n\n\n\n

\/\/ config\/filesystems.php\n\n'disks' => [\n    \/\/ ...\n    's3' => [\n        'driver' => 's3',\n        'key' => env('AWS_ACCESS_KEY_ID'),\n        'secret' => env('AWS_SECRET_ACCESS_KEY'),\n        'region' => env('AWS_DEFAULT_REGION'),\n        'bucket' => env('AWS_BUCKET'), \/\/ O nome do seu bucket S3\n        'url' => env('AWS_URL'), \/\/ Opcional, para CDN\/CloudFront\n    ],\n],\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
2. \ud83d\uddc4\ufe0f Interagindo com Discos<\/h2>\n\n\n\n
Voc\u00ea interage com o sistema de arquivos usando a Facade Storage<\/code><\/strong>, especificando qual disco deseja usar atrav\u00e9s do m\u00e9todo disk()<\/code>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Obtendo uma Inst\u00e2ncia de Disco<\/h3>\n\n\n\n
PHP<\/p>\n\n\n\n
use Illuminate\\Support\\Facades\\Storage;\n\n\/\/ Acessa o disco padr\u00e3o (geralmente 'local')\n$diskPadrao = Storage::drive(); \n\n\/\/ Acessa o disco S3\n$s3Disk = Storage::disk('s3'); \n\n\/\/ Acessa o disco local p\u00fablico\n$publicDisk = Storage::disk('public');\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Armazenando Arquivos (Uploads)<\/h3>\n\n\n\n
O m\u00e9todo mais comum para lidar com arquivos enviados via formul\u00e1rio \u00e9 o store()<\/code><\/strong>, dispon\u00edvel no objeto UploadedFile<\/code>. Ele lida com o streaming<\/em> e retorna o caminho gerado.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ Exemplo: Armazenando um arquivo enviado por formul\u00e1rio no S3\n\/\/ $request->file('arquivo') \u00e9 uma inst\u00e2ncia de UploadedFile\n\n\/\/ 'uploads' \u00e9 o subdiret\u00f3rio dentro do bucket (ou disco)\n\/\/ 's3' \u00e9 o nome do disco\n$path = $request->file('arquivo')->store('uploads', 's3');\n\/\/ $path pode ser, por exemplo: uploads\/u4dFj8lZk.jpg\n<\/code><\/pre>\n\n\n\n
Voc\u00ea tamb\u00e9m pode usar o m\u00e9todo put()<\/code><\/strong> para armazenar conte\u00fado bruto (string, stream) diretamente:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ Armazenando conte\u00fado de texto em um arquivo no S3\nStorage::disk('s3')->put('logs\/erro-2025.txt', 'Conte\u00fado do log de erro');\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
C. Recuperando Conte\u00fado<\/h3>\n\n\n\n
Use o m\u00e9todo get()<\/code><\/strong> para obter o conte\u00fado bruto do arquivo.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ Obtendo o conte\u00fado (string) de um arquivo no S3\n$contents = Storage::disk('s3')->get('uploads\/u4dFj8lZk.jpg');\nx<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. \ud83c\udf10 URLs e Visibilidade<\/h2>\n\n\n\n
A. Gerando URLs P\u00fablicas<\/h3>\n\n\n\n
Para o S3, os arquivos s\u00e3o privados por padr\u00e3o. Voc\u00ea precisa usar o m\u00e9todo url()<\/code> ou temporaryUrl()<\/code> para gerar um link acess\u00edvel.<\/p>\n\n\n\n