Creating your own Composer Package

Hi folks! I'd like to talk about to create your own dependency for Composer in this article. It's been one of the best invented tools for PHP ever in my humble opinion. Basically, you can manager your application's dependencies in a really easy way. If you haven't heard about it please check out the Compose website.

In this article I shall you show to create your own dependency using Github, deploy and maintain using Packagist.

Instalando ZF2

Salve galera! Após algumas semanas desde o lançamento resolvi instalar o Zend Framework 2 em minha máquina (Ubuntu 12.04) e analisar as mudanças que a nova versão trouxe. Abaixo vamos ver desde o download até ver a aplicação rodando. Sem mais nem menos vamos lá!

O pré-aquecimento

Vamos já deixar algumas coisas preparadas antes de começar o nosso trabalho. Eu configurei um  virtual host chamado local.zf2 e apontei o root para /var/www/zf2/public. Sinta-se livre para fazer como desejar. (Não sabe nada desse tal de Virtual Host? Clique aqui)

O download

Você pode fazer download do Skeleton do ZF aqui, basta clicar no botão ZIP. Eu optei por clonar o projeto no diretório /var/www como no comando abaixo . Chamei meu diretório de zf2:

$ cd /var/www
$ git clone https://github.com/zendframework/ZendSkeletonApplication.git zf2

A instalação

Uma vez feito, agora  usaremos o composer (não sabe do que estou falando? Aqui tem algumas dicas). Observe que você tem um arquivo no /var/www/zf2 chamado composer.json. Ele contém todas as informações necessárias para fazer o download das dependências:

$ composer self-update
$ composer install

Você terá em seu diretório zf2 algo como:

Teóricamente basta rodar no seu browser http://local.zf2 que você verá a tela de apresentação do ZF2.

Digite agora http://local.zf2/1234, e neste momento você deveria estar visualizando uma página como abaixo, caso contrário possívelmente você terá que verificar seu módulo rewrite do apache ou ainda configurar seu arquivo .htaccess.

Em breve estarei postando alguns exemplos de uso. Criação de rotas, controllers e etc.

Até mais!


Referências:
http://framework.zend.com/downloads/
http://framework.zend.com/manual/2.0/en/user-guide/skeleton-application.html
https://github.com/zendframework/ZendSkeletonApplication
http://meumysql.blogspot.com.br/2012/09/configurando-apache-e-zend-framework.html

Instalando o Symfony

Olá galera! Hoje, como um bom curioso que sou, fui fazer uma instalação do framework Symfony 2 para fins de testes e um possível uso do mesmo no meu website (www.mdnsolutions.com). Como sempre, há muito o que se aprender com o uso de uma nova ferramenta, então espero quer me apreciem este artigo e aprendam tanto quanto eu.

1 As dependências

Bem, já de cara na página de instalação há várias opções de download do Symfony, eu optei por utilizar o Composer para este fim. Contudo também não tinha o composer instalado (e acredito que nem mesmo vocês), então tive que realizar algumas pequenas tarefas antes de qualquer coisa.

1.1 O Composer

Não irei entrar em detalhes sobre o Composer neste artigo, mas você pode encontrar toda a documentação sobre ele aqui, acho de extrema importância saber como essa ferramenta funciona e estar atento as mudanças que ela esta/irá gerar na forma como os desenvolvedores php lidam com a distribuição de pacotes de suas aplicações.

1.1.1 Instalação

Primeira coisa é fazer o download do executável:

$ curl -s https://getcomposer.org/installer | php

Se alguma mensagem de erro pule em sua tela de uma olhada neste artigo. Caso contrário você deveria esta vendo essa mensagem:

$ curl -s https://getcomposer.org/installer | php

All settings correct for using Composer
Downloading...

Composer successfully installed to: /home/medina/composer.phar
Use it: php composer.phar

Agora vamos tornar o acesso ao binário que baixou global:

$ sudo mv composer.phar /usr/local/bin/composer

A partir de agora você digitar composer no seu console e verá uma lista de comandos que pode utilizar.


2 O Symfony

2.1 Instalação

Uma vez com o Composer funcionando vamos à instalação do nosso framework.

$ composer create-project symfony/framework-standard-edition path/ 2.1.2

Lembrando que path/ é o local onde você deseja criar seu projeto ex.: /var/www/meu_sf2. Aqui você vê um log que o comando gera.

2.1 Configuração

Lembre-se que você precisa preferencialmente de um servidor Apache 2 e PHP 5.3.8 ou superiores.

Remova o histórico de git que vem no pacote:

$ rm -rf .git

Podemos agora verificar se o nosso ambiente de trabalho atende as especificações de um projeto symfony rodando o comando abaixo ou o script "web/config.php" no endereço onde instalou sua aplicação. No meu caso criei um virtual host chamado "local.sf2" e rodei a url "http://local.sf2/web/config.php". (você pode verificar como criar um virtual host neste artigo).

$ php ./app/check.php 

Ele vai te dar uma ideia dos ajuste que você deveria fazer desde seu servidor apache até algumas variáveis do php.ini (ex. aqui).

No meu caso tive que instalar o Intl, uma extensão de internacionalização para executar collation e date/time/number/currency formatação nos scripts php:

$ sudo apt-get install php5-intl

, alterar a linha no  nano /etc/php5/apache2/php.ini

short_open_tag = Off

, instalar o APC do PHP. que você encontra aqui como fazer. E habilitar permissões de escrita para seu apache (nesse caso como é o meu local habilitei com 777)

$ chmod 777 -R app/cache/
$ chmod 777 -R app/logs/

2.2 Testando

Bem, seu Symfony neste ponto deveria estar instalado e pronto para rodar. O symfony tem um servidor interno que pode ser iniciado com:

$ php ./app/console server:run

E então digite em seu browser algo como:

http://localhost:8000/app_dev.php

Uma página com sua aplicação rodando deve está aparecendo em sua tela. Bem, é isso symfony rodando sucesso ao iniciar o desenvolvimento de sua aplicação.


Happy coding!


Referências:
http://www.symfony.com/
http://getcomposer.org/
http://packagist.org/
http://php.net/manual/en/intro.intl.php

Instalando o Composer: Erro timezone

Bem, instalando o Composer em meu computador me deparei com a seguinte mensagem:

Some settings on your machine may cause stability issues with Composer.
If you encounter issues, try to change the following:

The date.timezone setting should be provided.
Add the following to the end of your `php.ini`:
    ; UTC here is an example, use your own timezone, see http://www.php.net/manual/en/timezones.php
    date.timezone = UTC

Downloading...

Composer successfully installed to: /home/user/composer.phar
Use it: php composer.phar

Para resolver acesse o php.ini do cli como abaixo:

shell> nano /etc/php5/cli/php.ini 

E procure a linha date.timezone adicionando algum favor:

[Date]
; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'America/Sao_Paulo'

Pronto, problema resolvido. =)