{"id":1034,"date":"2024-05-20T19:41:02","date_gmt":"2024-05-20T22:41:02","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=1034"},"modified":"2025-12-02T16:27:57","modified_gmt":"2025-12-02T19:27:57","slug":"utilidades-sistema-de-arquivos","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/utilidades-sistema-de-arquivos\/","title":{"rendered":"Utilidades Sistema de Arquivos"},"content":{"rendered":"Tempo de leitura: <\/span> 4<\/span> minutos<\/span><\/span>\n

Utilidades Sistema de Arquivos<\/strong>: O PHP<\/strong> oferece um conjunto robusto de fun\u00e7\u00f5es que permitem interagir diretamente com o sistema de arquivos<\/strong> do servidor, uma funcionalidade essencial para qualquer aplica\u00e7\u00e3o web que precise ler configura\u00e7\u00f5es, registrar logs, armazenar dados ou gerenciar uploads<\/em> de usu\u00e1rios.<\/p>\n\n\n\n

Dominar a manipula\u00e7\u00e3o de arquivos e diret\u00f3rios \u00e9 crucial para criar sistemas de gerenciamento de conte\u00fado e lidar com dados persistentes.<\/p>\n\n\n\n

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

1. \ud83d\udcd6 Leitura e Escrita de Arquivos (Conte\u00fado Direto)<\/h2>\n\n\n\n

As fun\u00e7\u00f5es file_get_contents()<\/code><\/strong> e file_put_contents()<\/code><\/strong> s\u00e3o as formas mais simples e r\u00e1pidas de interagir com arquivos pequenos, pois lidam com a abertura e o fechamento do arquivo automaticamente.<\/p>\n\n\n\n

Fun\u00e7\u00e3o<\/strong><\/td>Prop\u00f3sito<\/strong><\/td>Exemplo PHP<\/strong><\/td><\/tr><\/thead>
file_get_contents(caminho)<\/code><\/strong><\/td>L\u00ea o conte\u00fado inteiro<\/strong> de um arquivo e o retorna como uma string<\/em>.<\/td>$conteudo = file_get_contents(\"config.json\");<\/code><\/td><\/tr>
file_put_contents(caminho, dado)<\/code><\/strong><\/td>Escreve o $dado<\/code> no arquivo, substituindo<\/strong> o conte\u00fado existente.<\/td>file_put_contents(\"log.txt\", \"Novo registro.\");<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Exemplo de Uso R\u00e1pido<\/h3>\n\n\n\n

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

<?php\n\/\/ Escrever em um arquivo\nfile_put_contents(\"novo_arquivo.txt\", \"Este \u00e9 o novo conte\u00fado.\");\n\n\/\/ Ler e exibir o conte\u00fado\n$conteudo = file_get_contents(\"novo_arquivo.txt\");\necho $conteudo; \n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
2. \ud83d\uddc2\ufe0f Manipula\u00e7\u00e3o de Arquivos por Fluxo (Ponteiros)<\/h2>\n\n\n\n
Para arquivos muito grandes ou para opera\u00e7\u00f5es sequenciais (como leitura bloco a bloco ou escrita incremental), voc\u00ea deve usar as fun\u00e7\u00f5es baseadas em ponteiros (fluxo).<\/p>\n\n\n\n
Fun\u00e7\u00e3o<\/strong><\/td>Prop\u00f3sito<\/strong><\/td>Exemplo PHP<\/strong><\/td><\/tr><\/thead>
fopen(caminho, modo)<\/code><\/strong><\/td>Abre<\/strong> o arquivo no modo especificado (\"r\"<\/code> para leitura, \"w\"<\/code> para escrita\/cria\u00e7\u00e3o, \"a\"<\/code> para anexar\/append).<\/td>$arquivo = fopen(\"dados.txt\", \"r\");<\/code><\/td><\/tr>
fread(ponteiro, bytes)<\/code><\/strong><\/td>L\u00ea<\/strong> um n\u00famero espec\u00edfico de bytes.<\/td>$dados = fread($arquivo, 1024); \/\/ L\u00ea 1KB<\/code><\/td><\/tr>
fwrite(ponteiro, dado)<\/code><\/strong><\/td>Escreve<\/strong> uma string<\/em> no arquivo.<\/td>fwrite($arquivo, \"Novo Log\\n\");<\/code><\/td><\/tr>
fclose(ponteiro)<\/code><\/strong><\/td>Fecha<\/strong> o arquivo e libera o recurso.<\/td>fclose($arquivo);<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Exemplo de Fluxo (Escrita)<\/h3>\n\n\n\n
PHP<\/p>\n\n\n\n
<?php\n$ponteiro = fopen(\"log.txt\", \"a\"); \/\/ Abre para anexar (append)\nfwrite($ponteiro, \"Acesso em \" . date(\"Y-m-d H:i:s\") . \"\\n\");\nfclose($ponteiro); \/\/ Sempre feche o ponteiro!\n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. \ud83d\udcc2 Fun\u00e7\u00f5es de Diret\u00f3rio<\/h2>\n\n\n\n
Fun\u00e7\u00e3o<\/strong><\/td>Prop\u00f3sito<\/strong><\/td>Exemplo PHP<\/strong><\/td><\/tr><\/thead>
mkdir(caminho)<\/code><\/strong><\/td>Cria um novo diret\u00f3rio<\/strong>.<\/td>mkdir(\"novo_diretorio\");<\/code><\/td><\/tr>
rmdir(caminho)<\/code><\/strong><\/td>Remove um diret\u00f3rio, mas ele deve estar vazio<\/strong>.<\/td>rmdir(\"diretorio_vazio\");<\/code><\/td><\/tr>
scandir(caminho)<\/code><\/strong><\/td>Retorna um array<\/strong> com os arquivos e diret\u00f3rios dentro de um caminho.<\/td>$arquivos = scandir(\"uploads\");<\/code><\/td><\/tr>
is_dir(caminho)<\/code><\/strong><\/td>Verifica se o caminho especificado \u00e9 um diret\u00f3rio<\/strong>.<\/td>if (is_dir(\"uploads\")) { ... }<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
4. \ud83d\udd0d Verifica\u00e7\u00e3o e Metadados<\/h2>\n\n\n\n
Fun\u00e7\u00e3o<\/strong><\/td>Prop\u00f3sito<\/strong><\/td>Exemplo PHP<\/strong><\/td><\/tr><\/thead>
file_exists(caminho)<\/code><\/strong><\/td>Verifica se um arquivo ou diret\u00f3rio existe<\/strong>.<\/td>if (file_exists(\"config.php\")) { ... }<\/code><\/td><\/tr>
is_file(caminho)<\/code><\/strong><\/td>Verifica se o caminho \u00e9 um arquivo regular<\/strong>.<\/td>if (is_file(\"dados.txt\")) { ... }<\/code><\/td><\/tr>
filesize(caminho)<\/code><\/strong><\/td>Retorna o tamanho<\/strong> do arquivo em bytes<\/strong>.<\/td>echo filesize(\"imagem.jpg\");<\/code><\/td><\/tr>
filemtime(caminho)<\/code><\/strong><\/td>Retorna o hor\u00e1rio da \u00faltima modifica\u00e7\u00e3o<\/strong> (timestamp).<\/td>$modificacao = filemtime(\"dados.txt\");<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
5. \u23eb Upload de Arquivos: A Superglobal $_FILES<\/code><\/h2>\n\n\n\n
Para processar arquivos enviados atrav\u00e9s de um formul\u00e1rio HTML, voc\u00ea precisa da superglobal<\/em> $_FILES<\/code><\/strong>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Formul\u00e1rio HTML (Obrigat\u00f3rio)<\/h3>\n\n\n\n
O formul\u00e1rio deve ter o atributo enctype=\"multipart\/form-data\"<\/code><\/strong> e o m\u00e9todo POST<\/code><\/strong>.<\/p>\n\n\n\n
HTML<\/p>\n\n\n\n
<form action=\"upload.php\" method=\"post\" enctype=\"multipart\/form-data\">\n    Selecione o arquivo: <input type=\"file\" name=\"arquivo_usuario\">\n    <input type=\"submit\" value=\"Enviar\">\n<\/form>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
Estrutura da $_FILES<\/code><\/h3>\n\n\n\n
Se o nome do campo no HTML for arquivo_usuario<\/code>, a superglobal ter\u00e1 a seguinte estrutura ap\u00f3s o envio:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
$_FILES['arquivo_usuario'] = [\n    'name' => 'nome_original.jpg', \/\/ Nome original do arquivo no cliente\n    'type' => 'image\/jpeg',        \/\/ Tipo MIME do arquivo\n    'tmp_name' => '\/tmp\/phpXyZ',   \/\/ Caminho tempor\u00e1rio no servidor\n    'error' => 0,                  \/\/ C\u00f3digo de erro (0 = sucesso)\n    'size' => 123456               \/\/ Tamanho do arquivo em bytes\n];\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
Processamento e Movimenta\u00e7\u00e3o Segura<\/h3>\n\n\n\n
A fun\u00e7\u00e3o move_uploaded_file()<\/code><\/strong> \u00e9 a \u00fanica forma segura de mover um arquivo do diret\u00f3rio tempor\u00e1rio para o local permanente no seu sistema.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
<?php\nif (isset($_FILES['arquivo_usuario']) && $_FILES['arquivo_usuario']['error'] == UPLOAD_ERR_OK) {\n    \n    $nome_arquivo = basename($_FILES['arquivo_usuario']['name']); \/\/ Limpeza b\u00e1sica de nome\n    $tmp_name = $_FILES['arquivo_usuario']['tmp_name'];\n    $destino = \"uploads\/\" . $nome_arquivo; \n    \n    \/\/ Move de forma segura o arquivo tempor\u00e1rio para o destino final\n    if (move_uploaded_file($tmp_name, $destino)) {\n        echo \"Arquivo $nome_arquivo enviado com sucesso!\";\n    } else {\n        echo \"Erro ao mover arquivo.\";\n    }\n}\n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
6. \u26a0\ufe0f Seguran\u00e7a e Boas Pr\u00e1ticas<\/h2>\n\n\n\n