O PHP faz isso a um bom tempo já, e um bom exemplo é a função error_reporting, onde podemos utilizar uma série de regras para denominar quais os erros devem ser reportados.

error_reporting(E_ERROR | E_WARNING);

No exemplo acima, foi denominado que somente os tipos de erro E_ERROR e E_WARNING devem ser reportados. Se quiséssemos que o tipo de erro E_PARSE fosse reportado também, bastariamos adiciona-lo na regra:

error_reporting(E_ERROR | E_WARNING | E_PARSE);

Mas como isso funciona?

Utilizando como exemplo, essas contantes do PHP contém os seguintes valores:

E_ERROR		1
E_WARNING	2
E_PARSE		4

O operador | é uma operação “Or” inclusiva, o que indica que, todo bit que estiver presente em A ou B, será utilizado.

0001 ou
0010
=
0011

Podemos verificar o valor em binário de cada uma das constantes, utilizando a função printf:

$ php -r 'printf("%04b", E_ERROR);'
0001
$ php -r 'printf("%04b", E_WARNING);'
0010
$ php -r 'printf("%04b", E_PARSE);'
0100

Portanto, voltando ao exemplo inicial da função error_reporting, temos:

E_ERROR | E_WARNING

E se fizermos a operação, obteremos 0011, vejamos:

$ php -r 'printf("%04b", E_ERROR | E_WARNING);'
0011

E como verificamos se E_ERROR esta contido em E_ERROR | E_WARNING?

Simples. Basta utilizar o operador &, que realiza uma operação “And”, onde somente são utilizados os bits presentes em A e B.

(E_ERROR | E_WARNING) & E_ERROR

Traduzindo em bits, ficaria:

0011 e
0001
=
0001

Veja que o resultado tem o mesmo valor de B, e é assim que funciona, basta comparar E_ERROR com o resultado de (E_ERROR | E_WARNING) & E_ERROR.

Agora em PHP, já que um exemplo vale mais que mil palavras:

if (E_ERROR == ((E_ERROR | E_WARNING) & E_ERROR))
{
	echo 'E_ERROR presente nas regras';
}

Criando a sua própria série de regras

Imagine uma situação, onde você possui um sistema com vários usuários, e cada usuário pode conter as permissões P_READ (leitura), P_WRITE (escrita), P_REMOVE (remoção).

Criamos então, uma permissão “base”, chamada P_NONE (nada).

define('P_NONE',	100);

E em seguida, as outras permissões:

define('P_READ',	P_NONE << 1);
define('P_WRITE',	P_NONE << 2);
define('P_REMOVE',	P_NONE << 3);

Logo, podemos criar uma regra para um usuário:

$mode = P_READ | P_WRITE;

E armazena-la em um banco de dados. Aqui utilizei um campo int, em um banco de dados MySQL.

mysql_query("update users set mode = $mode where id = $id");

Posteriormente, você pode listar os usuários que tem permissão para escrita:

$mode = P_WRITE;
$users = mysql_query("select * from users where (mode & $mode) = $mode");

Para verificar com PHP:

if (P_READ == ($user->mode & P_READ))
{
	echo 'Este usuário possui permissão para leitura.';
}

Conclusão

Você pode especificar várias e várias regras, utilizando apenas um valor, uma variável ou um campo no banco de dados. Basta utilizar alguns bits e operações lógicas.

Para maiores informações sobre os Bitwise Operators do PHP, basta acessar a URL:

http://br2.php.net/language.operators.bitwise

A explicação demonstra como requisitar links, como criar uma página de erro personalizada, e como utilizar o seu domínio para acessa-los.

Porém não há limites. Basta usar o seu conhecimento junto da sua criatividade para criar o seu próprio encurtador, sem maiores preocupações.

Faça o download do código completo.

Vamos tomar como exemplo o seguinte cenário:

Você possui um blog ou uma agência digital, e quer espalhar os seus links através de um domínio próprio, no qual os seus clientes confiem meramente, e que não tenham medo de acessar achando que é algum vírus.

Neste tutorial, teremos 4 arquivos:

.htaccess

Para melhor o “visual” das URL’s

307.class.php
Classe para manipulação de links do 307.to

shorturl.php
Onde utilizamos a classe do 307.to

404.php
Página de erro personalizada

A classe do 307

A classe class307 possui os seguintes métodos:

public function set_format($format)

Específica o formato do retorno, podendo ser json ou text.

public function set_account_key($key)

Específica a chave da sua conta.

public function get($u)

Requisita um link.

public function post($u)

Cria um link, se account_key for específicado o link será anexado a sua conta.

Utilizando a classe

Esse é o script principal do sistema, onde é utilizada a classe do 307 para requisitar os links.

Como você pode ver abaixo, o método set_account_key foi comentado para fins de demonstração, porém ele é extremamente importante, pois permita que somente os links criados por você possam ser acessados através do seu domínio.

<?php

require '307.class.php';

$class307 = new class307;
// optional
//$class307->set_account_key('<YOUR ACCOUNT KEY>');

try
{
	if (is_array($_GET['link']) || empty($_GET['link']))
	{
		throw new Exception();
	}

	$link = $_GET['link'];
	$url = $class307->get($link);

	//header('Location: ' . $url, TRUE, 307);
	header('Location: http://307.to/' . $link);
}
catch (Exception $error)
{
	include '404.php';
}

Indo logo para a parte mais importante do código, verificamos se a variável “link” é do tipo Array ou se esta vazia. Caso um dos dois casos ocorra, geramos uma exceção.

if (is_array($_GET['link']) || empty($_GET['link']))
{
...
}

Logo depois, requisitamos o endereço através do método get:

$url = $class307->get($link);

Caso o link não exista, o método get gerará uma exceção, caso contrário continuará a execução.

Veja que ocorrendo alguma exceção, o arquivo 404.php será chamado e logo em seguida a execução terminará.

Utilizando a URL retornada

Se o método get conseguir encontrar a URL, ela será armazenada na variável $url, no script de exemplo, eu somente utilizei o método get para verificar se o link existe ou não, e então redirecionei para a página do próprio 307.to onde serão geradas estatísticas de acesso e tudo mais. Mas nada impede que você faça a sua própria coleta de estatísticas e então redirecione o usuário para a página final.

Testando o script

Para testar o script, basta realizar as seguintes requisições:

http://seusite.com.br/shorturl.php?link=rG

e

http://seusite.com.br/shorturl.php?link=ESSE_LINK_NAO_EXISTE

Veja que a primeira requisição irá redirecionar para http://307.to/rG, enquanto a segunda exibirá uma página de erro (404.php).

Personalizando a URL (Escondendo o shorturl.php)

Para encurtar o link, você pode usar algumas regras no .htaccess, que permitem que você esconda o nome do arquivo, no caso “shorturl.php”.

.htaccess

RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ shorturl.php?link=$1

Agora para acessar o seu link, basta requisitar o endereço:

http://seusite.com.br/rG

Personalizando a página de erro (404.php)

Para personalizar a página de erro, basta ter um pouco de conhecimento de HTML:

404.php

<html>
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
</head>
<body>

<h1>Erro - Link não encontrado</h1>

<em>
<?php
printf('%d - %s', $error->getCode(), $error->getMessage());
?>
</em>

</body>
</html>

Download do código

Para fazer o download do código completo citado, basta clicar no link abaixo:

Download

PHP

O que são Hooks?

Hooks são arquivos que são carregados na inicialização do Kohana, permitindo você adicionar ou modificar funções, chamadas callbacks, que são disparadas pelo Kohana.

Essas funções (ou callbacks) são colocados em uma lista dentro do seu evento específico, chamada Event Queue.

O que são Eventos?

Durante a inicialização, e até mesmo durante a execução, em alguns casos, o núcleo do Kohana dispara vários eventos. Eventos que são definidos pelo próprio núcleo.

Você pode ver a lista completa de eventos disparados pelo Kohana, na documentação: http://docs.kohanaphp.com/general/events

Habilitando os Hooks no Kohana

Para começar a brincar com os Hooks, é necessário habilitá-los. Para isso, basta configurar a opção enable_hooks no config/config.php, para TRUE:

$config['enable_hooks'] = TRUE;

Exemplo de utilização de Hooks

Suponha que tenhamos um site com sistema de autenticação.

Quando um visitante chega, ele é logo direcionado ao controller padrão, definido em config/routes.php, pela seguinte linha:

$config['_default'] = 'site';

O controller site, contém os métodos (páginas): Home (com formulário de autenticação), Quem Somos, Ajuda…

Agora, o que fazer quando este visitante já estava autenticado anteriormente, e retorna ao site?

A solução mais simples a se fazer, é criar uma verificação no controller site, e caso o usuário já esteja autenticado ele será redirecionado à outro controller, chamado painel.

Problema

A cada redirecionamento do controller site ao controller painel, seria realizado outra inicialização do sistema completo.

Solução

Uma solução elegante e correta para isso, é utilizar um Hook para informar ao Router, o controller correto a ser chamado.

O Router é quem define através da URL, qual controller deverá ser chamado, portanto a única coisa que terá de ser feita, é dizer à ele qual controller ele deverá chamar.

Criamos então, o arquivo hooks/site.php, o nome não importa, a não ser por fácil identificação posteriormente.

No arquivo, é especificado que no momento do evento system.routing, uma função (leia-se callback) será chamada, antes do Router::setup.

Esse callback definirá o controller correto à ser carregado.

<?php defined('SYSPATH') OR die('No direct access allowed.');

function hook_define_controller_padrao()
{
	if (!empty(Router::$current_uri)) return;
	if (Session::instance()->get('user'))
		// usuário logado
		Router::$current_uri = 'painel';
}

Você pode também impossibilitar o acesso à página de autenticação, quando o usuário já estiver autenticado, modificação a função callback acima, da seguinte forma:

function hook_define_controller_padrao()
{
	$logado = Session::instance()->get('user');
	if (empty(Router::$current_uri) && $logado)
		// usuário autenticado
		Router::$current_uri = 'painel';
	elseif (Router::$current_uri == 'site/login' && $logado)
		// exibir "página não encontrada"
		Event::run('system.404');
}

Criada a função, é necessário que seja adicionada à lista de eventos a serem realizados, isso pode ser feito logo abaixo da função, ou no final do arquivo Hook.

Event::add_before(
	'system.routing',
	array('Router', 'setup'),
	'hook_define_controller_padrao'
);

Existe também como definir novos eventos, mas isso fica para outro artigo, pois este é somente uma introdução sobre o assunto.

Utilize os Hooks sempre que possível, eles poderão reduzir inúmeras linhas no seu código, tornando-o mais enxuto, legível e organizado.

Serve também para aqueles que estão começando a se familiarizar com o framework e querem aprender um pouco mais sobre as possibilidades que ele oferece.

Singleton

Singleton é um padrão (Design Pattern) que garante que suas classes serão instânciadas somente uma vez, podendo ser acessadas de forma global, evitando a criação de várias instâncias desnecessarias da mesma.

No KohanaPHP isso pode ser aplicado nas bibliotecas, pois todas as bibliotecas tem suporte a Singleton.

Ao invés de criar uma nova instância:

$this->session = new Session;

Você utiliza o método estático instance:

$this->session = Session::instance();

O que o método instance cria uma nova instância, armazena-a em uma variável, e a retorna. Na próxima chamada é feita uma verificação, caso uma variável com a instância já exista, ao invés de criar uma nova, ele retorna a instância contida na variável.

Utilize o Query Builder

Muita gente odeia Query Builders por serem um tanto limitados, porém se você quiser que a sua aplicação seja independente de banco de dados, use-o. Deixe para escrever SQL’s somente quando for realmente necessários.

O Query Builder suporta method chaining, o que pode deixar o código mais elegante.

Exemplos de Method Chaining com Query Builder

$result = $this->db->select('id, nome')
                   ->from('tabela')
                   ->where(array('categoria' => 1))
                   ->limit(10)
                   ->get();

$result = $this->db->select('id')
                   ->getwhere('tabela', array('categoria' => 2));

Contando total de registros em uma tabela

$total_usuarios = $this->db->count_records('usuarios');

Utilize segmentos, de preferência nomeados

Ao invés de usar variáveis $_GET, dê preferência aos segmentos. Além de mais elegantes, são mais fáceis de serem manipulados.

http://meusite/clientes/busca/cidade/Bauru/estado/SP

Onde clientes é o controller, busca é o método, e cidade e estado são segmentos.

$cidade = uri::segment('cidade');

$estado = uri::segment('estado');

Nunca modifique os arquivos do diretório system

Os recursos disponíveis pelo Kohana, são carregados no formato de cascata, ou seja, primeiro ele verifica se o arquivo existe no diretório application, caso não exista, então procura nos diretórios de cada módulo, em seguida no diretório system.

Um bom exemplo são os arquivos de configuração, localizados no diretório system/config/.

O caminho percorrido até ele chegar em qualquer arquivo dentro deste diretório, é o seguinte:

application/config/auth.php
--> modules/archive/config/auth.php
--> modules/flot/config/auth.php
--> modules/auth/config/auth.php (encontrado)

Caso não fosse encontrado, ele continuaria a pesquisar, terminando no diretório system:

system/config/auth.php

Por isso é muito importante transferir todos os arquivos necessários para o diretório application, e nunca modifica-los nos seus diretórios de origem.

Use os helpers e bibliotecas disponíveis

O Kohana disponibiliza uma série de helpers e bibliotecas que podem facilitar e muito o desenvolvimento. Não invente a roda à todo momento.

Exemplo de utilização do helper Upload

$filename = $_FILES['arquivo']['name'];
$tmp_name = $_FILES['arquivo']['tmp_name'];

$filename_path = upload::save(array
(
	'name' => $filename,
	'tmp_name' => $tmp_name
), $filename);

$filename = basename($filename_path);

Exemplo de utilização da biblioteca Pagination

$this->pagination = new Pagination(array
(
	'base_url'       => 'noticias/page/',
	'uri_segment'    => 'page',
	'total_items'    => $total_num_rows,
	'items_per_page' => $rows,
	'style'          => 'digg'
));

echo $this->pagination;

No exemplo acima, será impressa uma paginação no estilo Digg.

Existem outros estilos de paginação que podem ser conferidos através da documentação:

http://docs.kohanaphp.com/libraries/pagination

Estenda os helpers, sempre que necessário

Uma prática muito encorajada no Kohana é a extensão dos helpers para se adequar as suas necessidades.

Por exemplo, podemos estender o helper format, para formatar também o tamanho de arquivos, criando o arquivo MY_format.php dentro do diretório helpers da sua apliação, geralmente application/helpers.

applications/helpers/MY_format.php

<?php defined('SYSPATH') or die('No direct script access.');

class format extends format_Core
{
	public static function filesize($size)
	{
		$sizes = array('B', 'kB', 'MB', 'GB',
		            'TB', 'PB', 'EB', 'ZB', 'YB');
		$c = count($sizes) - 1;
		for ($i = 0; $size > 1024 && $i < $c; $i++)
			$size /= 1024;
		return round($size, 2) . $sizes[$i];
	}
}

echo format::filesize(1024*4); // 4kB

Lembre-se, todo arquivo de extensão deve ser iniciado por MY_, é um padrão definido pelo Kohana.

Internacionalização

Criar uma aplicação multi-idiomas com o Kohana é relativamente simples.

Primeiro crie o diretório i18n dentro de applications, e em seguida crie o diretório pt_BR.

applications/i18n/pt_BR/

Após isso, as strings são divididas entre arquivos, dentro desse diretório, por exemplo:

applications/i18n/pt_BR/caption.php

Dentro de cada arquivo, são especificadas as strings:

<?php defined('SYSPATH') OR die('No direct access allowed.');

$lang = array
(
	'submit' => 'Enviar',
	'cancel' => 'Cancelar',
	'confirm' => 'Confirmar',
);

echo Kohana::lang('caption.submit'); // Enviar

Também é permitido a utilização de Arrays:

'confirm' => array
(
	'edit?' => 'Editar texto?',
	'remove?' => 'Remover texto?'
);

echo Kohana::lang('message.confirm.edit?'); // Editar texto?

O objetivo desse material, é disponibilizar um caminho para os Web Designers aprenderem um pouco mais sobre PHP, explicando algumas instruções básicas (se-então-senão, include, por exemplo), e algumas funções que geralmente são úteis, e facilitam o desenvolvimento básico de sites e layouts.

O manual do PHP

Tudo o que será demonstrado nesse artigo, esta documentado no manual oficial do PHP, onde inclusive existem exemplos e comentários de outras pessoas.

O manual do PHP é uma ótima fonte de referência. Lá você tem uma explicação detalhada para a utilização de praticamente todas as funções, e pode ser encontrado aqui: http://www.php.net/manual/pt_BR/index.php

Uma forma rápida de acesso ao manual, é ir direto na página da função desejada, por exemplo:

http://php.net/include
http://php.net/echo
http://php.net/date
http://php.net/string

Os tipos de dados

Os principais tipos de dados em PHP, são: Booleanos, Inteiros, Números de ponto flutuante e Strings.

Não abordarei os demais tipos de dados, pois não serão comentados neste material introdutório.

Booleano, é o tipo de dado Sim / Não, Verdadeiro / Falso, 1 / 0.

Em PHP são descritos como true e false, ou 1 e 0. Onde 1 é true, e 0 é false.

Inteiros (Z), os que você aprendeu no ensino fundamental: …, -2, -1, 0, 1, 2, …

Números de Ponto Flutuante, são números reais: -1.15, 0.333333, 1, 1.5, 400.20, …

e finalmente, uma String é uma cadeia de caracteres (texto, frase, palavra…):

Uma string em PHP é descrita dentre ‘ (aspas simples) ou ” (aspas duplas).

A diferença entre uma string entre aspas simples, e outra entre aspas duplas, é que a string entre aspas duplas, sempre espera por receber uma variável (dentro dela), como será visto mais além, durante a leitura.

“String entre aspas duplas”

‘String entre aspas simples’

Comentários

Assim como no HTML, o PHP também possui comentários, vejamos:

Em HTML:

<!-- Comentário no meio de um arquivo HTML -->

em PHP:

<?php

// Comentário no meio de um arquivo PHP (somente uma linha)

/*
Comentário para
várias linhas, em PHP
(várias linhas)
*/

?>

As condições If-then-else (Se-então-senão)

Não se assute com essa parte do material, pois é só um pré-requisito para o melhor entendimento do material por um todo. Você conseguirá entender melhor isso conforme o andamento da leitura, vendo a aplicação disso na prática.

O if-then-else trabalha em cima de condições, condições que são geralmente são avaliadas através de Operadores Comparativos e Operadores Lógicos.

Os principais Operadores Comparativos, são: == (igual), != (diferente), < (menor), > (maior), <= (menor ou igual), >= (maior ou igual).

Os principais Operadores Lógicos, são: && (e), || (ou) e ! (negação).

Na prática, isso tudo é muito simples:

1 == 1, 1 é igual à 1
1 != 2, 1 é diferente de 2

1 < 2, 1 é menor que 2
2 > 1, 2 é maior que 1

1 <= 2, 1 é menor ou igual à 2
2 >= 2, 2 é maior ou igual à 2

Agora em conjunto com os Operadores Lógicos:

1 == 1 && 1 < 2, 1 é igual à 1, E, 1 é menor que 2.
2 > 1 && 2 >= 2, 2 é maior que 1, E, 2 é maior ou igual à 2.

A sintaxe do if-then-else é mais simples ainda:

If

se (verdade), então
	faz isso
fim

If, Else

se (verdade), então:
	faz isso
senão
	faz isso 2
fim

Agora, traduzindo para o PHP, seria:

If

if (condicao for verdade)
{
	echo 'faz isso';
}

If, Else

if (condicao for verdade)
{
	echo 'faz isso';
}
else
{
	echo 'faz isso 2';
}

O PHP também suporta o Else-If (Senão-se):

<?php
	if (numero < 0)
	{
		// Numéro negativo
	}
	elseif (numero < 5)
	{
		// Número menor que 5
	}
	elseif (numero <= 10)
	{
		// Número menor ou igual a 10
	}
	else
	{
		// Um número qualquer, acima de 10
	}
?>

Existe também outra forma de se fazer um If, que é chamado de Operador Ternário:

CONDICAO ? ENTAO : SENAO

em PHP:

<?php 1 == 1 ? 1 : O; ?>

Explicando: Se 1 é igual a 1, então 1, senão 0.

O include

A instrução include pode facilitar muito na criação do layout, pois possibilita separar o layout em arquivos, como no exemplo abaixo:

<?php include 'cabecalho.php'; ?>

Olá Mundo!

<?php include 'rodape.php'; ?>

Notas

• O arquivo utilizado no include não precisa necessáriamente ser PHP, pode ser qualquer tipo de arquivo de texto plano, ou seja, nada de imagens, claro.
• O que o include faz, basicamente, é embutir o arquivo especificado formando um único arquivo.
• Um include pode também conter outros include’s. Você pode ter um include chamado menu.php dentro do seu cabecalho.php.

Utilização de Variáveis

Suponha que o arquivo cabecalho.php contenha o seguinte trecho de código:

<html>
<head>
	<title>Título da Página</title>
</head>

Veja que se você utilizar o arquivo cabecalho.php, em todas as suas páginas, todas as páginas terão o mesmo título, pois ele esta definido de forma estática, imutável.

Caso queira que cada página contenha um título diferente, por exemplo: Início, Blog e Contato.

Você deve especificar que o arquivo cabecalho.php contém uma área de conteúdo variável, sujeita a modificações, mutável. Isso é feito através da utilização de variáveis.

Como exemplo, um arquivo chamado contato.php, conteria o seguinte trecho de código:

<?php
	$titulo_da_pagina = 'Contato';
?>

<?php include 'cabecalho.php'; ?>

Entre em contato conosco... Telefone: (99) 9999-9999

<?php include 'rodape.php'; ?>

E no arquivo cabecalho.php seria especificada a variável, no lugar do título:

<html>
<head>
	<title>Meu Site | <?php echo $titulo_da_pagina; ?></title>
</head>

A instrução echo, basicamente imprime o que é passado de parâmetro. No caso acima, uma variável, que foi pré-definida com o conteúdo: Contato

A sintaxe da variável é simples. Para a criação, utiliza-se:

$nomedavariavel = 'Conteudo da variavel';

O $ (sifrão) é o que identifica uma variável. O nome das variáveis podem conter somente letras, números e _ (underline), mas nunca devem começar com número. O conteúdo delas pode variar:

<?php
	$se_for_um_texto = 'Utilize aspas simples...';
	$se_for_um_texto = "ou aspas duplas";
	$se_for_um_numero = 15;
	$se_for_um_valor = 99.99;
?>

Para imprimir uma variável é mais simples:

<?php echo $nomedavariavel; ?>

Utilizando uma variável para especificar um include

Como nós vimos, a sintaxe para um include é a seguinte:

include <STRING>;

Para você poder inserir uma variável dentro da string, a string deverá iniciar e terminar com ” (aspas duplas). Pois uma string com aspas duplas, indica que ela poderá conter variáveis, então tratará o $ (sifrão) de forma diferente, como se fosse uma variável.

$pagina = 'historia'; // não haverá nenhuma variável no meio da string

include "includes/$pagina.php"; // existe uma variável no meio da string

Lembre-se, que se você utilizar aspas simples em uma string que contém uma variável, o sifrão será impresso como se fosse um sifrão mesmo:

<?php
	echo 'minha variável $teste';
	// imprimirá: minha variável $teste
?>

Notas

• Lembre-se de utilizar o “;“, caso contrário terá problemas.
• Prefira usar ‘ na maioria das vezes, use “ apenas quando for necessário colocar uma variável dentro da string.
• Em alguns códigos, você pode encontrar a função “print” no lugar do “echo“, as duas fazem praticamente a mesma coisa, mas dê sempre preferência ao echo.

Verificação de tipos de variáveis

Você pode verificar se uma variável é do tipo que você espera, exemplos:

<?php
	if (is_int(1))
		echo 'verdadeiro';
	if (is_numeric(1.5))
		echo 'verdadeiro';
	if (is_string('foobar'))
		echo 'verdadeiro';
	if (is_string(100))
		echo 'falso';
?>

Variáveis Globais: $_GET e $_POST

Supondo que você tenha uma página chamada teste.php, vamos fazer alguns testes com essas variáveis globais.

A variável global $_GET, serve para transportar uma variável da URL para dentro do seu código, por exemplo, tendo o teste.php com o seguinte conteúdo:

<?php echo $_GET['pagina']; ?>

Ao chamarmos: http://seusite/teste.php?pagina=exemplo, você terá:

exemplo

E basicamente é isso. Porém também temos que trabalhar visando que essa variável pode não existir, então é necessário trata-la, para evitar erros, então usamos a condição if-then-else junto à função empty.

A função empty retorna TRUE, caso a variável:

1. Não exista
2. Seja 0 (zero)
3. Seja false (booleano)
4. Esteja em branco

Caso contrário, retorna true.

<?php
	if (empty($_GET['pagina']))
	{
		echo 'a variável página não existe, ou esta vazia';
	}
	else
	{
		echo $_GET['pagina'];
	}
?>

As variáveis $_GET são comumente utilizadas em includes, porém deve haver um cuidado muito grande.

Sempre verifique qual o conteúdo da variável antes de coloca-la no include, por exemplo:

if (empty($_GET['pagina'])) $pagina = NULL;
else $pagina = $_GET['pagina'];

if ($pagina == 'historia') include 'historia.php';
elseif ($pagina == 'contato') include 'contato.php';
elseif ($pagina == 'noticias') include 'noticias.php';
else include 'default.php';

NUNCA utilize:

include $_GET['pagina'] . '.php';

Pois isso poderá ocasionar uma invasão no seu site, mas isso não é o foco do artigo, apenas não faça-o, tenha total controle do que será incluso.

A variável global $_POST, é geralmente utilizada em formulários, de login por exemplo, onde não é recomendado óbviamente mostrar a senha na URL.

Variáveis $_POST são criadas quando um formulário é especificado com method=”POST”, por exemplo:

form.php

<form method="POST" action="teste.php">
	Nome: <input type="text" name="meunome" />
	Idade: <input type="text" name="idade" />
	<input type="submit" value="Enviar" />
</form>

Para recuperar o valor desse campo no PHP, você teria de fazer:

teste.php

<?php
	// verificando se o método é mesmo POST
	if ($_SERVER['REQUEST_METHOD'] == 'POST')
	{
		if (empty($_POST['meunome']))
			$meunome = ''; // nenhum nome especificado
		else
			$meunome = $_POST['meunome'];

		if (empty($_POST['idade'))
			$idade = 0;
		else
			$idade = $_POST['idade'];

		// função is_int(), utilizada pra verificação do tipo Inteiro
		if (is_int($idade) && $idade >= 18)
			echo "Bem-vindo $nome"; // imprimindo saudação
		else
			echo "Conteúdo proibido para menores";
	}
?>

Simples não?

Trabalhando com Datas

Você pode automatizar aquele famoso “Copyright” no rodapé da página, utilizando a função date() do PHP:

rodape.php

<div class="rodape">
Todos os direitos reservados &copy 2008-<?php echo date('Y'); ?>
</div>
</body>
</html>

O que vai “dentro” de uma função, é chamado de argumento. No exemplo acima, foi passado apenas um argumento, do tipo string: ‘Y’, o que diz à função date que queremos o ano (Year). Então, será impresso:

Todos direitos reservados &copy 2008-2009

Exibindo a data de hoje:

<?php echo date('d/m/Y'); ?>

Verificando se é Manhã, Tarde ou Noite (Comentado)

<?php
	// Hora
	$hora = date('H');
	// se Hora for maior que 18 ou menor que 5
	// de 18:01 até 23:59 ou 0 até 04:59
	if ($hora > 18 || $hora < 5) echo 'Boa Noite';
	// se Hora for menor que 12
	// de 05:00 até 11:59
	elseif ($hora < 12) echo 'Bom dia';
	// senão... é de tarde
	// de 12:00 até 18:00
	else echo 'Boa tarde';
?>

Uma lista com todos os formatos para a função “date” pode ser encontrada no manual do PHP, em: http://www.php.net/manual/en/function.date.php

Tratamento de Strings

strtolower()

A função strtolower() transforma todos caracteres em letras minúsculas.

Exemplo

<?php echo strtolower('FooBar'); ?>

Imprimirá

foobar

Manual

http://br2.php.net/strtolower

strtoupper()

A função strtoupper() é o inverso da strtolower(), transforma todos caracteres em letras maiúsculas.

Exemplo

<?php echo strtoupper('foobar'); ?>

Imprimirá

FOOBAR

Manual

http://br2.php.net/strtoupper

number_format()

A função number_format() formata números, valores por exemplo.

Exemplo

R$ <?php echo number_format(1300.40, 2, ',', '.'); ?>

Imprimirá

R$ 1.300,40

Manual

http://br2.php.net/number_format

trim()

A função trim() remove espaços no começo e no fim da string.

Exemplo

<?php echo trim('   Texto'); ?>

É muito útil também para fazer validações:

<?php
	if (trim($nome) == '')
		echo 'Nome em branco';
?>

Imprimirá

Texto (sem nenhum espaço no começo)

Manual

http://br2.php.net/trim

wordwrap()

A função wordwrap() quebra um texto em partes, a cada N caracteres.

Exemplo

<?php echo wordwrap('um texto muito, mas muito longo.', 8, '<br />'); ?>

Imprimirá

um texto<br />
 muito, <br />
mas muit<br />
o longo.

Manual

http://br2.php.net/wordwrap

nl2br()

A função nl2br() transforma quebras de linha em <br /> (HTML). Muito útil também quando retornando um campo texto, de um banco de dados.

Exemplo

<?php echo nl2br('um
outro texto
só para exemplo...'); ?>

Imprimirá

um<br />
outro texto<br />
só para exemplo...

Manual

http://br2.php.net/nl2br

strlen()

A função strlen() retorna quantos caracteres a string possui.

Exemplo

<?php echo strlen('cinco'); ?>

Imprimirá

5

Manual

http://br2.php.net/strlen

htmlentities()

A função htmlentities() converte caracteres que podem ocasionar problemas no seu HTML, como <, > e & em entidades correspondentes, como: &lt;, &gt; e &amp.

Exemplo

<?php echo strlen('<foo>bar&'); ?>

Imprimirá

&lt;foo&gt;bar&amp;

Manual

http://br2.php.net/htmlentities

urlencode()

A função urlencode() serve para você codificar uma string de uma forma que ela fique de acordo com a especificação, do que é permitido utilizar em uma URL.

Exemplo

<?php
	$titulo = 'Primeira noticia, teste';
	echo 'http://meusite/noticia.php?id=10&titulo=' . urlencode($titulo);
?>

Imprimirá

http://meusite/noticia.php?id=10&titulo=Primeira+noticia%2C+teste

Manual

http://br2.php.net/urlencode

urldecode()

A função urldecode() é o inverso da urlencode().

Exemplo

<?php echo urldecode('Primeira+noticia%2C+teste'); ?>

Imprimirá

Primeira noticia, teste

Manual

http://br2.php.net/urldecode

$ sudo apt-get install php-pear
...
$ pecl version
PEAR Version: 1.7.1
PHP Version: 5.2.6-2ubuntu4.1
Zend Engine Version: 2.2.0

php -r 'phpinfo();' | grep php.ini

Funciona em Linux e Unix*.

Update

Segundo o Walter Cruz, algumas distribuições como o Debian podem organizar os php.ini’s da vida de forma diferente, uma para cada situação: php cli, php cgi e mod_php.

Então se você estiver utilizando uma dessas distribuições, pode criar um arquivo test.php:

echo "<?php phpinfo(); ?>" > test.php

Acessá-lo por CGI ou mod_php através do seu browser, e verificar o caminho especificado em Configuration File (php.ini) Path.

Após isso, os passos seguem pelo terminal. Verifique se o comando port existe:

$ which port

Caso não exista, crie um atalho:

$ sudo ln -s /opt/local/bin/port /usr/bin/port

Atualize a lista de pacotes (é como se fosse um apt-get update do debian):

$ sudo port -v selfupdate

Em seguida, você pode utilizar o comando abaixo para procurar programas:

$ port search apache2

Como nós vamos instalar o php5. É melhor instalarmos ele e como opção instalar o apache2 e mais alguns pacotes adicionais, como o mysql5, se você desejar. Para listar os pacotes adicionais ao php5, utilize a linha abaixo:

$ port -v variants php5

Ele vai exibir uma série de variantes, escolha quais você quer instalar e mande instalar:

$ sudo port -v install php5 +apache2 +mysql5

Após isso, você pode verificar que o apache2 e o php5 foram instalados, com a linha:

$ port installed | grep -i apache2\\\|php5

Other PHP functions can be found in the PHP.JS Project: http://phpjs.org/

• Source code

Examples of usage

var time = new Date(strtotime('now'));

alert([time.getFullYear(),
time.getMonth() + 1, /* in javascript the months start in 0 */
time.getDate()].join('-'));

var time = new Date(strtotime('+1 week',<?php echo time()*1000;?>));

alert(time.getDate());

var time = new Date(strtotime('Wed, 18 Oct 2005 13:00:00'));

alert(time.getFullYear());

var time = new Date(strtotime('2008-12-26 15:30'));

alert(time.getMonth());

var time = new Date(strtotime('+1 day'));

alert(time.getDate());

var time = new Date(strtotime('last month'));

alert(time.getMonth() + 1);

var time = new Date(strtotime('5 years ago'));

alert(time.getFullYear());

var time = new Date(strtotime('+1 week 2 days 4 hours 2 seconds'));

alert(time.getDate());

Algumas dúvidas relacionadas a este material podem ser retiradas através do documentação do próprio Kohana PHP, em http://docs.kohanaphp.com/.

Começando *bem* do começo, o começo do começo..

1. Faça o download do Kohana no site http://kohanaphp.com/
2. Renomeie a pasta Kohana_vX.X.X para agenda.
3. Deixe o diretório application/logs com permissão para escrita.
4. Edite o arquivo application/config.php e altere site_domain para o respectivo caminho onde se encontra o kohana, /agenda/, caso seja http://localhost/agenda/.

E vamos lá..

Primeiro vamos “limpar” o kohana, removendo os exemplos, que nesse tutorial, não serão utilizados.

1. Apague todos arquivos que estão dentro da pasta application/controllers
2. Apague todos arquivos que estão dentro da pasta application/views

Crie um novo arquivo, application/controllers/agenda.php, que será um controller.

<?php defined('SYSPATH') or die('No direct script access.');

class Agenda_Controller extends Controller
{

    public function create()
    {
        /* Aqui iremos chamar a view, que esta localizada dentro
         * da pasta "views/", o .php pode ser omitido.
         */
        $view = new View('create');
        $view->render(true);
    }

}

?>

Crie agora, o arquivo application/views/create.php, que será a view chamada pelo método create dentro do controller Agenda.

<form action="<?php echo url::site('agenda/create'); ?>" method="post">
    <label for="name">Nome:</label>
        <input id="name" name="name" type="text" />
    <label for="phone">Telefone:</label>
        <input id="phone" name="phone" type="text" />
    <input type="submit" value="Salvar" />
</form>

Repare, que na view create.php, usamos o método url::site(). O método site, faz parte do helper url, que contém um conjunto de métodos úteis que ajudaram no desenvolvimento de suas aplicações, o método site retorna o caminho site_domain + controller/metodo.

Aqui já podemos chamar a url http://localhost/agenda/index.php/agenda/create

E através dessa url você já pode perceber que o formato das url’s é:

index.php/controller/método

Caso queira, você também pode usar subdiretórios dentro da pasta applications/controllers, por exemplo agenda/escola/contatos.php, onde contatos.php é um controller com nome Contatos_Controller, e pode ser acessado através da url agenda/index.php/agenda/escola/contatos. Enfim, isso não vem ao caso agora.

Voltando, vamos dar vida a nossa aplicação. Crie um banco de dados para a agenda:

CREATE DATABASE `agenda` ;

CREATE TABLE `agenda`.`contacts` (
  `id` int(11) NOT NULL auto_increment,
  `name` varchar(255) NOT NULL,
  `phone` varchar(255) NOT NULL,
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM AUTO_INCREMENT=2 DEFAULT CHARSET=utf8

Agora, copie o arquivo system/config/database.php para application/config/database.php, na pasta system/config ficam todos arquivos de configuração padrão, como nós não vamos usar uma “base de dados padrão”, então copiamos o arquivo para a pasta da nossa aplicação.

Edite o arquivo application/config/database.php, configurando o acesso ao seu banco de dados:

‘user’ => ‘usuário’,
‘pass’ => ’senha_do_usuario’,
‘database’ => ‘agenda’

E então vamos alterar o método create no nosso controller agenda, para que adicione nossos dados ao banco de dados.

public function create()
{
    if (request::method() == 'post')
    {
        $name  = (string) @$_POST['name'];
        $phone = (string) @$_POST['phone'];

        // aqui inserimos os dados no banco
        $db = new Database;
        $db->insert('contacts', array('name' => $name, 'phone' => $phone));

        // redirecionamos para o metodo "contacts"
        url::redirect('agenda/contacts');
    }
    /* Aqui iremos chamar a view, que esta localizada dentro
     * da pasta "views/", o .php pode ser omitido.
     */
    $view = new View('create');
    $view->render(true);
}

Você já pode testar o formulário, porém ele dará erro, pois ainda não criamos o método contacts, que será criado agora:

public function contacts()
{
    /* Primeiro vamos retornar a lista de contatos do banco de dados
     * e guarda-la na variável $result
     */
    $db = new Database;
    $result = $db->get('contacts');
    /* Aqui iremos chamar a view (views/contacts.php),
     * passando a variável de nome "result".
     */
    $view = new View('contacts', array('result' => $result));
    $view->render(true);
}

E a view contacts.php ficará assim:

<table border="0">
<tbody>
<tr>
<th>ID</th>
<th>Nome</th>
<th>Telefone</th>
<th></th>
</tr>
<?php foreach ($result as $r): ?>
<tr>
<td><?php echo $r->id; ?></td>
<td><?php echo $r->name; ?></td>
<td><?php echo $r->phone; ?></td>
<td>
    <?php
        echo html::anchor('agenda/edit/' . $r->id, 'Editar');
    ?>
</td>
</tr>
<?php endforeach; ?>
</tbody></table>

Observe que foi utilizado mais um helper, html::anchor(), que basicamente cria um link <a href=”">…</a>.

Bom, agora que já temos o método create, o contacts (list) falta o edit, certo?

public function edit($id = null)
{
    $db = new Database;
    $id = (int) $id;
    $result = $db->limit(1)->getwhere('contacts', array('id' => $id));
    if (count($result) == 0)
    {
        /* Caso não exista um contato com este id
         * retorna uma página "not found" do kohana
         */
        Event::run('system.404');
    }
    /* Se chegou até aqui, é porque achou o registro
     */
    $row = $result[0];
    /* Conferimos se é um método http post,
     * se for, salvamos o registro
     */
    if (request::method() == 'post')
    {
        $name  = (string) @$_POST['name'];
        $phone = (string) @$_POST['phone'];

        // aqui inserimos os dados no banco
        $db = new Database;
        $db->update('contacts',
                    array('name' => $name, 'phone' => $phone),
                    array('id' => $row->id));

        // redirecionamos para o metodo "contacts"
        url::redirect('agenda/contacts');
    }
    /* E então, chamamos a view responsável..
     */
    $view = new View('edit', array('row' => $row));
    $view->render(true);
}

E então a view edit.php

<form action="<?php echo url::site('agenda/edit/' . $row->id); ?>"
      method="post">

<label for="name">Nome:</label>
<input id="name"
       name="name"
       type="text"
       value="<?php echo $row->name; ?>" />

<label for="phone">Telefone:</label>
<input id="phone"
       name="phone"
       type="text"
       value="<?php echo $row->phone; ?>" />

<input type="submit" value="Salvar" />

</form>

Deixe o seu comentário. ;)