README

Note: This repository contains a set of functions that may help us, Brazilians, with common tasks, such date conversion and string masks. So, for now on, this documentation will be written in portuguese (pt_BR)

Esse repositório disponibiliza um conjunto de funções para algumas tarefas simples que passamos em todo novo projeto: conversão de datas, formatação de strings, etc...

Instalação

Utilizaremos o composer para a instalação desse pacote.

Basta adicionar a linha abaixo ao seu arquivo composer.json:

"vsmoraes/helpers": "dev-master"

Ou executar:

composer require vsmoraes/helpers

Funções disponívels

str_mask($string, $mask)

Aplica uma máscara à uma string

$telefone = str_mask('11999999999', '(##) #####-###'); // Resultado: (11) 99999-9999

format_cpf($cpf)

Retorna a string formatada como CPF

$cpf = format_cpf('99999999999'); // Resultado: 999.999.999-99

format_cnpj($cnpj)

Retorna a string formatada como CNPJ

$cnpj = format_cnpj('99999999999999'); // Resultado: 99.999.999/9999-99

format_cep($cep)

Retorna a string formatada como CEP

$cep = format_cep('99999999'); // Resultado: 99999-999

format_telefone($telefone)

Retorna a string formatada como telefone

$telefone = format_telefone('99999999999'); // Resultado: (99) 99999-9999

format_data($date, [$from_format = 'Y-m-d'], [$to_format = 'd/m/Y'])

Converte o formato da data

$date = '2015-04-01';
$date = format_data($date); // Resultado: 01/04/2015

Você pode fazer a conversão inversa também (ou usar qualquer outro formato)

$date = '01/04/2015';
$date = format_data($date, 'd/m/Y', 'Y-m-d'); // Resultado: 2015-04-01

filesize_format($bytes, [$precision = 2])

Converte de bytes pra KB, MB, GB out TB

$bytes = 230 * 1024; // 
$filesize = filesize_format($bytes); // Resultado: 230KB

Testes

php vendor/bin/phpunit