caioariede.com weblog

Bitwise Operators

Caio Ariede — Mon, 09 Nov 2009 01:53:11 +0000

Uma forma muito elegante de armazenar uma série de regras, utilizando um só valor, é utilizando os Bitwise Operators.

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

Usando o Git para deploy de sites

Caio Ariede — Mon, 02 Nov 2009 16:48:40 +0000

Neste artigo, assume-se que você tenha um site hospedado em um servidor, que esteja rodando Git e SSH.

Repositório local

Crie um repositório local normalmente, caso já tenha, pule esta etapa.

$ mkdir meusite.com.br
$ cd meusite.com.br

$ git init

Repositório remoto

Neste exemplo, vou utilizar a estrutura que o Plesk utiliza para aos domínios.

Precisamos de uma pasta que fique fora de visibilidade da web, portanto, utilizarei a pasta private, que fica na raiz do domínio.

$ cd /var/www/vhosts/meusite.com.br/private

Criamos a pasta do repositório:

$ mkdir meusite.git/
$ cd meusite.git/

Iniciamos um repositório “crú” no mesmo local:

$ git --bare init

E então configuramos o Git com as seguintes opções:

$ git config core.worktree /var/www/vhosts/meusite.com.br/httpdocs
$ git config core.bare false
$ git config receive.denycurrentbranch ignore

Configuramos também o Hook que será executado após toda atualização:

$ cat > hooks/post-receive
#!/bin/bash
SITE_PATH=/var/www/vhosts/meusite.com.br

cd $SITE_PATH/httpdocs
git --work-tree=. --git-dir=$SITE_PATH/private/meusite.git checkout -f

E colocamos permissão para execução:

$ chmod +x hooks/post-receive

Processo de atualização

O processo para atualização é bem simples. Primeiro criamos outro “master” branch, chamado “web”.

$ git remote add web ssh://meusite@servidor.com.br/var/www/vhosts/meusite.com.br/private/meusite.git

Em seguida, realize qualquer alteração:

$ echo "funcionou!" > teste.html
$ git commit -am 'teste'

$ git push web +master:refs/heads/master

Tente acessar: http://meusite.com.br/teste.html

Após isso, você pode atualizar somente com “git push web”, configurando:

$ git config push.default current

Quaisquer dúvidas sobre o Git, podem ser retiradas através do canal #git na irc.freenode.net.

Este material foi baseado no Using Git to manage a web site.

Criando o seu próprio encurtador de URL’s usando a API do 307.to

Caio Ariede — Fri, 21 Aug 2009 18:51:45 +0000

Demonstrar de forma simples objetiva, que é totalmente possível criar o seu próprio encurtador de URL’s de maneira simples, sem se preocupar com banco de dados, estatísticas, etc…

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.

require '307.class.php';

$class307 = new class307;
// optional
//$class307->set_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

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

Erro - Link não encontrado

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

Download do código

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

Download

Instalando o emesene no Gentoo Linux

Caio Ariede — Sun, 26 Jul 2009 17:51:41 +0000

O emesene (emesene.org), não esta disponível oficialmente nos repositórios do Gentoo, porém pode ser instalado através de um Overlay.

Um Overlay é uma árvore separada da árvore principal de pacotes do Gentoo, mantida por terceiros.

O Overlay onde o emesene esta disponível, chama-se dottout, e requer a instalação do git.

Portanto, primeiramente instale o git:

# emerge dev-util/git

* Vá tomar um cafézinho, pois demora um pouco!

Depois do café, adicione o Overlay, através do layman:

# layman -a dottout

Depois disso, antes de instalar o emesene, é preciso satisfazer uma dependência, que é a libmimic.

Crie o arquivo /etc/portage/package.keywords/libmimic, especificando a arquitetura da sua máquina, no meu caso “~x86″:

# cat >/etc/portage/package.keywords/libmimic
media-libs/libmimic ~x86

E em seguida dê emerge:

# emerge media-libs/libmimic

Após a instalação, especifique também a arquitetura da sua máquina para a instalação do emesene:

# cat >/etc/portage/package.keywords/emesene
net-im/emesene ~x86

E então, dê emerge:

# emerge emesene

Vá até o diretório do emesene, normalmente localizado em /usr/share/emesene, e execute o setup.py:

# cd /usr/share/emesene
# python setup.py build_ext -i

emesene instalado!

* Lembre-se, o emesene não roda como usuário root.

Ajudando a traduzir o site do Kohana PHP

Caio Ariede — Thu, 18 Jun 2009 23:01:25 +0000

Esclarecerei aqui, como ajudar na tradução do site do projeto Kohana PHP.

Primeiramente, baixe e instale o Subversion.

Caso você utilize Ubuntu/Linux, Debian, ou alguma distribuição parecida, você pode instalar através do terminal, usando o comando:

sudo apt-get install subversion

Caso você utilize outra distribuição, ou Windows, mais informações para download estão disponíveis em http://subversion.tigris.org/getting.html#binary-packages

Após a instalação

Após instalar o Subversion, caso esteja no Linux, abra o terminal.

Caso esteja no Windows, vá em Iniciar > Executar, digite “cmd” e execute.

Crie uma pasta, no lugar que desejar. Aqui eu optei por ~/kohana.

Esta é a pasta onde você baixará os arquivos do site do Kohana, para fazer isso, vá até a pasta e execute o comando abaixo:

svn co http://source.kohanaphp.com/branches/website/application kohana-website

Esse comando baixará somente a pasta application, pois fora dela, não há conteúdo a ser traduzido.

Após o término, você terá os arquivos em sua máquina.

Realizando o primeiro Patch

O Patch, ou Correção, nada mais é que a diferença entre o arquivo antigo e o novo (modificado).

Portanto, você irá modificar o arquivo em questão, e realizar o patch através do SVN mesmo. Ele possui uma ferramenta que faz isso.

Para montar esse Mini How To, eu realizarei um patch, no arquivo: i18n/pt_BR/layout.php

Realizei algumas alterações no arquivo, comparando com a versão atual em inglês i18n/en_US/layout.php, adicionei duas traduções que faltavam: menu_redmine e menu_projects.

Após isso, é bastante simples. Somente fui até a pasta, através do terminal e gerei o patch, com o comando:

svn diff i18n/pt_BR/layout.php > patch_i18n_pt_BR_layout.patch

Eu acho importante manter uma padronização no nome dos patches.

Finalizando, envio do Patch

Foi criado um Ticket no site do Kohana, onde devem ser adicionados os patches, para isso basta se cadastrar no site, ir até o Ticket e enviar o arquivo.

O Ticket criado para isso, foi o #1799.

Espero que esse documento seja de bastante utilidade, e que todos consigam compreender bem.

Kohana PHP: Brincando com os Hooks

Caio Ariede — Tue, 26 May 2009 13:59:11 +0000

Os Hooks do Kohana PHP são realmente úteis. Demonstrarei como utiliza-los, exemplificando a sua utilização em uma situação real.

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.

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.

TTYtter: Twitter no console

Caio Ariede — Sat, 23 May 2009 19:17:35 +0000

Aplicativos modo-texto são realmente muito úteis, é claro que, para quem sabe como utilizá-los de forma adequada, e digamos que produtiva.

Tenho visto em muitos blogs, pessoas ensinando como usar o Twitter através da linha de comando, com o cURL. Apesar de ser uma forma interessante, não é algo prático, o que torna a utilização no dia-a-dia inviável, principalmente para pessoas que utilizam muito o Twitter.

Assim como já escrevi sobre o cmus, um tocador de músicas com playlist, modo texto, resolvi escrever um pouco sobre TTYtter para demonstrar que é possível utilizar aplicativos na linha de comando, de uma forma viável.

TTYtter

O TTytter é um cliente para Twitter interativo e multi-funcional, que nada mais é que um script Perl.

A sua página oficial é http://www.floodgap.com/software/ttytter/

Instalação

Na verdade não é bem uma instalação, basicamente você terá de baixar o script, e só. Por ser um script Perl, não há o processo de compilação, bastando somente você ter o Perl instalado (o que é muito provável que já esteja).

A instalação tem como base o sistema operacional Linux, podendo ser aplicada também a sistemas Unix-like.

Você pode baixa-lo com o wget direto para o seu diretório de programas ou /usr/local/bin, da seguinte forma:

$ sudo wget http://www.floodgap.com/software/ttytter/ttytter.txt -O /usr/local/bin/ttytter

A opção -O utilizada no wget especifica o arquivo onde será salvo.

Após isso, dê permissão para execução ao ttytter:

$ sudo chmod +x /usr/local/bin/ttytter

Retire o sudo, caso não seja necessário na distribuição que esteja usando.

Utilização

Você pode iniciar o TTYtter manualmente, digitando:

$ ttytter -user=seuusuario:suasenha -ansi

A opção -ansi é para habilitar as cores.

Ou então, para facilitar, pode-se criar um script:

Crie um arquivo com um nome qualquer e coloque o conteúdo abaixo dentro dele.

Aqui eu criei um arquivo chamado ttytter, dentro da pasta app.

#!/bin/bash
usuario=caioariede
read -s -p "Senha: " senha
ttytter -user=$usuario:$senha -ansi

Dê ao arquivo permissão para execução:

$ chmod +x app/ttytter

Configure o script com os seus dados e execute-o:

$ ./app/ttytter

Comandos

/refresh

Atualização, busca por novos tweets.

/whois

Exibe informações do perfil do usuário.

TTYtter> /whois caioariede
caio (caioariede) (f:116/176) (u:3014)
"php programmer, python and linux enthusiast, workaholic,
learning erlang, using ion3 and vim"
Location:   Bauru
URL:        ...
Picture:    ...

/replies

Exibe seus últimos “replies” e menções (tweets referindo o seu usuário)

/dmagain

Exibe suas últimas “direct messages”

/reply

Responde a um tweet.

g4> mensagem
TTYtter> /reply g4 mensagem de resposta

A mensagem enviada será um reply:

@foo mensagem de resposta

/delete

Remove um tweet, se for seu é claro.

g5> mensagem teste
/delete g5

/help

Use para ver outros comandos e informações sobre o TTYtter.

Kohana PHP: Boas práticas de desenvolvimento

Caio Ariede — Wed, 20 May 2009 13:03:19 +0000

Este artigo tem como objetivo relembrar algumas das funcionalidades disponibilizadas pelo excelente framework Kohana PHP. Funcionalidades estas que podem facilitar, e muito, na hora de desenvolver ou refatorar uma aplicação.

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

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:

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?

PHP para Web Designers

Caio Ariede — Sat, 16 May 2009 18:16:23 +0000

Objetivo

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:

em 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:

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 (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):

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:

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:

include 'cabecalho.php'; ?>

Olá Mundo!

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:

>
>
>Título da Página>
>

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:

$titulo_da_pagina = 'Contato';
?>

include 'cabecalho.php'; ?>

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

include 'rodape.php'; ?>

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

Meu Site | <?php echo $titulo_da_pagina; ?>

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:

$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:

echo $nomedavariavel; ?>

Utilizando uma variável para especificar um include

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

include ;

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:

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:

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:

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:

Não exista
Seja 0 (zero)
Seja false (booleano)
Esteja em branco

Caso contrário, retorna true.

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

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

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

teste.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

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:

Exibindo a data de hoje:

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

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

// 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

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

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$ 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

echo trim(' Texto'); ?>

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

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

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

Imprimirá

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

Manual

http://br2.php.net/wordwrap

nl2br()

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

Exemplo

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

Imprimirá

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

Manual

http://br2.php.net/nl2br

strlen()

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

Exemplo

echo strlen('cinco'); ?>

Imprimirá

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: <, > e &.

Exemplo

echo strlen('bar&'); ?>

Imprimirá

<foo>bar&

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

$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

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

Imprimirá

Primeira noticia, teste

Manual

http://br2.php.net/urldecode

Montando um SFTP em um diretório local com SSHFS

Caio Ariede — Mon, 04 May 2009 03:56:25 +0000

Montar um FTP como se fosse um diretório local na maquina pode facilitar a vida de muita gente. Principalmente pessoas que trabalham com desenvolvimento WEB e precisam fazer atualizações direto no FTP. Mesmo que não recomendado, às vezes é necessário, até mesmo para enviar arquivos.

Vou exemplificar aqui utilizando o Ubuntu, porém mesmo em outras distribuições Linux, a ideia pode ser reutilizada.

Supondo que você tenha um FTP no endereço example.org, vamos criar uma estrutura como essa abaixo, onde possibilitará posteriormente a adição de novos endereços (FTP’s).

/home/seuusuario/ftp
/home/seuusuario/ftp/example.org
/home/seuusuario/ftp/example.org/sftpmount (script para montagem)
/home/seuusuario/ftp/example.org/www (arquivos no servidor)

Então vamos lá.

Primeiro baixe o SSHFS
sudo apt-get install sshfs
Vamos criar o diretório para o nosso FTP
mkdir -p ~/ftp/example.org/www
cd ~/ftp/example.org

A opção -p no mkdir, faz com que ele crie todos os diretórios antecedentes ao www, ftp e example.org.
Agora crie um script para montar o FTP mais facilmente
gedit sftpmount

Coloque a linha abaixo no arquivo, modificando às suas necessidades:

echo senha | sshfs -o password_stdin usuario@example.org:public_html www

Lembre-se de alterar também onde esta public_html para o seu diretório remoto.

A senha é opcional, você pode omiti-la retirando o echo e a opção -o password_stdin.
Dê permissão de execução para o script
chmod +x sftpmount
Execute o script
./sftpmount
Se tudo ocorrer normalmente, você verá os arquivos listando o diretório www:
ls www/