Standard PHP Library - Parte 2
Há algum tempo havia escrito sobre a SPL e fiquei por publicar outros artigos sobre o assunto. Infelizmente não consigo manter a regularidade de publicação que gostaria aqui no blog, mas vou indo na medida do possivel.
A partir da versão 5 do PHP a SPL já vem importada nativamente, o que facilita a utlização dos recursos que ela oferece. Desde então os desenvolvedores do PHP vem trabalhando pesado para melhorar o suporte a orientação a objetos. É claro que até lá ainda há um longo caminho a percorrer e isso requer um grande esforço de toda comunidade.
Isso certamente trará beneficios, tornando a linguagem mais madura, robusta, sem perder a simplicidade que a tornou tão popular. Há também os lados negativos, por exemplo a incompatibilidade de scripts desenvolvidos para versões anteriores, mas acredito que o "prejuizo" seja por uma boa causa. Já está na hora de resolvermos problemas de inconsistencia na padronização da nomeclatura das funções das bibliotecas nativas da linguagem (algumas utilizam o separador undescore como str_replace e outras não, como strlen), o que provoca em perda de produtividade.
A SPL veio com o objetivo de prover funcionalidades básicas, organizadas através de classes e interfaces, que evitam que o programador precise reinventar a roda e permitindo que ele possa focar suas atenções para a solução dos reais problemas. Nada pior do que perder horas para resolver problemas que foram criados pela própria linguagem.
A seguir demonstrarei como utilizar as classes de manipulação de arquivos SplFileInfo e SplFileObject.
SplFileInfo
Esta classe fornece todas as informações disponíveis para um determinado aquivo, passado como paramento na instanciação do objeto.
-
<?
-
$file = new SplFileInfo("./meu_arquivo.txt");
-
?>
A partir disso, o objeto fornece os seguintes métodos:
- getATime(): Data em timestamp do último acesso ao arquivo.
- getCTime(): Data em timestamp da criação do arquivo.
- getGroup(): Retorna o group do arquivo (disponível apenas em sistemas unix).
- getInode(): Retorna o inode do arquivo (disponível apenas em sistemas unix).
- getMTime(): Data em timestamp da última modificação do arquivo.
- getPath(): Retorna o diretório no qual o arquivo está contido.
- getPerms(): Retorna as permissões do arquivo.
- getRealPath(): Retorna o caminho completo até o arquivo.
- getSize(): Retorna o tamanho do arquivo em bytes.
- isDir(): Retorna um valor booleano informando se o arquivo é do tipo diretório
- isExecutable(): Retorna um valor booleando informando se o arquivo é um executável válido.
- isFile(): Retorna um valor booleando informando se o arquivo é mesmo um arquivo, e não um diretório ou um link.
- isLink(): Retorna um valor booleando informando se o arquivo é um link para outro arquivo ou diretório.
- isReadable(): Retorna um valor booleando informando se o arquivo pode ser lido ou não.
- isWritable(): Retorna um valor booleando informando se o arquivo pode ser alterado ou não.
- openFile(): retorna um objeto do tipo SplFileObject, que será apresentado abaixo.
Estas funções fornecem os principais dados que podemos obter dos arquivos, e com certeza pode resolver muitos problemas. Principalmente as funções getMTime(), isWritable() e getSize() são comumente utilizadas no nosso dia-a-dia.
SplFileObject
Esta classe herda a classe SplFileInfo. Logo ela possui todas os métodos que a classe explicada acima possui, porém implementa também a manipulação do conteúdo do arquivo.
-
<?
-
$file = new SplFileObject("./meu_arquivo.txt");
-
?>
Colocarei apenas os métodos mais importantes a seguir:
- eof(): Retorna um valor booleando indicando se o ponteiro está no fim do arquivo.
- fflush(): Força a escrita em disco do buffer do arquivo.
- fgetc(): Retorna uma string contendo apenas um caracter lido do arquivo.
- fgets(): Retorna uma linha do arquivo.
- fscanf($format): Interpreta a leitura de um arquivo de acordo com o formato passado como parametro.
- fseek($pos): Move o ponteiro do arquivo.
- fstat(): Retorna um vetor com detalhes do arquivo.
- ftell(): Retorna um inteiro com posição do ponteiro no arquivo.
- ftruncate($size): Reduz o tamanho do arquivo ao tamanho especificado.
- fwrite($string): Escreve o conteúdo da string no arquivo.
- rewind(): Volta o ponteiro para o inicio do arquivo.
- seek($line): Muda o ponteiro para linha especificada.
Estas funções são basicamente as funções oferecidas pela biblioteca atual do PHP, organizadas em objetos e permite a iteração já que esta classe também estende a interface Iterator. É importante relembrar também que estes métodos são nativos e tão eficientes quanto as funções já existentes.
Vale a pena dar uma conferida nas ferramentas oferecias pela SPL na sua oculta documentação.