Development

Documentation/pt_BR/book/1.0/03-Running-Symfony

You must first sign up to be able to contribute.

Executando o Symfony

Como você aprendeu em capítulos precedentes, a estrutura Symfony é um conjunto de arquivos escritos em PHP. Um projeto Symfony usa estes arquivos, e assim que são instalados, já se tornam disponíveis para o projeto.

Por ser uma estrutura em PHP 5, Symfony requer PHP 5. Certifique-se que você tem o mesmo instalado abrindo uma linha de comando e digitando este comando:/

Se o número de versão for 5.0 ou mais atual, você está pronto para a instalação, como descrito neste capítulo.

Instalando a Caixa de Areia

Se você quiser apenas ver o que o Symfony é capaz, você irá provavelmente para a instalação rápida. Nesse caso, você necessita da Caixa de Areia.

A Caixa de Areia é uma coleção simples de arquivos. Contem um projeto symfony vazio incluindo todas as bibliotecas requeridas (Symfony, o pake, cal, Creole, propele, e Phing), uma aplicação padrçao, e a configuração básica. Trabalhará fora da caixa, sem configuração específica do usuário ou nenhuns pacotes adicionais.

Para instalá-lo, faça o download o arquivo da Caixa de Areia de http://www.symfony-project.com/get/sf_sandbox.tgz. Descompacte-o no diretório raiz do servidor configurado para seu usuário (geralmente WWW). Para fins de padronização, este capítulo suporá que você o descompactou no diretório sf_sandbox/.

amarelo

Ter todos os arquivos sob o diretório raiz do servidor é muito bom para seus próprios testes em um host local, mas é uma prática má em um usuário de produção. Isso faz com que o interior da sua aplicação fique visível à usuários finais.

fim do amarelo

Teste sua instalação executando o Symfony CLI. Vá ao novo diretório sf_sandbox/ e digite o seguinte num sistema *nix.

COMANDO

No Windows, este comando:

COMANDO

Você pode visualizar o número da versão da Caixa de Areia

Agora se certifique que seu Servidor Web possa navegar na Caixa de Areia requisitando a seguinte URL

URL

Você deve ver uma página agradecendo a instalação como na figura 3-1, e significa que sua instalação está terminada. Se não, então uma mensagem de erro o guiará através das mudanças de configuração necessitadas. Você pode também consultar à seção “de pesquisa de problemas” mais tarde neste capítulo.

Figura 3-1 - Página dos agradecimentos da Caixa de Areia

FIGURA

A Caixa de Areia tem a finalidade de que você pratique a utiulização do Symfony em um computador local, e não desenvolver as aplicações complexas que podem terminar no Servidor Web. Entretanto, a versão do Symfony o com a Caixa de Areia é inteiramente funcional e equivalente a essa que você pode instalar através do PEAR.

Ao desinstalar uma Caixa de Areia, remova apenas o diretório de sf_sandbox/de seu diretorio do Servidor Web . Instalando as bibliotecas Symfony

Ao desenvolver uma aplicação, você necessitará provavelmente instalar duas vezes o Symfony: uma vez para seu ambiente do desenvolvimento e uma vez para o Host (a menos que seu Host já tenha o Symfony instalado). Para cada usuário, você vai querer provavelmente evitar a duplicação mantendo todas os arquivos Symfony em um único lugar, se você desenvolve somente uma aplicação ou diversas aplicações.

Como a estrutura Symfony evolui rapidamente, uma nova versão estável poderá ser liberada alguns dias após sua primeira instalação. Você necessita pensar do melhoramento da estrutura como um interesse principal, e essa é uma outra razão porque você deve compartilhar de um exemplo das bibliotecas Symfony através de todos seus projetos Symfony.

Quando se instalam as bibliotecas para o desenvolvimento real da aplicação, você tem duas alternativas:

  • A instalação do PEAR é recomendada para a maioria das pessoas. Pode fàcilmente ser compartilhada e promovida, e o processo da instalação é direto.
  • A instalação do Subversion (SVN) deve ser usada somente pelos colaboradores avançados de PHP, que querem fazer exame das melhoiias dos consertos mais atrasados, adicionam características do seus próprios, e/ou as contribuem ao projeto Symfony.

Symfony integra alguns outros pacotes:

  • o pake é uma utilidade de CLI.
  • o cal é uma utilidade testando da unidade.
  • O Creole é um motor de abstração da base de dados. Assicom como Dados objetos PHP (PDO), ele fornece uma relação entre seu código e o código do SQL da base de dados, e fará possível comutar a um outro motor.
  • Propelir é para ORM. Fornece a persistência do objeto e o serviço da pergunta.
  • Phing é um CLI para propele.

Pake e o cal são desenvolvidos pela equipe Symfony. O Creole, propele, e Phing vem de uma outra equipe e é liberado sob o GNU uma pequena licença geral pública (LGPL). Todos estes pacotes são empacotados com o Symfony. Instalando o pacote da PERA de Symfony

O pacote symfony do PEAR contem as bibliotecas Symfony e todas suas dependências. Contem também um certificado que estenda seu CLI para incluir o comando Symfony.

A primeira etapa para instalá-lo é adicionar o canal Symfony ao PEAR, executando este comando:

COMANDO

Agora você está pronto para instalar a última versão estável do Symfony. Emitir este comando:

COMANDO

É isto. Os arquivos e os CLI Symfony são instalados. Certifique-se de que a instalação termine chamando a linha de comando symfony nova, pedindo o número de versão:

COMANDO

amarelo

Se você preferir instalar o beta o mais recente, que tem os reparos e os realces os mais recentes de erros, o tipo PEAR instala symfony/symfony-beta preferivelmente. As liberações Beta não são completamente estáveis e não são recomendadas geralmente para ambientes da produção.

Fim do amarelo

Como o segue Symfony do como dos diretórios do agora no. dos instaladas do são dos bibliotecas:

  • $php_dir/symfony/contem como principais dos bibliotecas.
  • $data_dir/symfony/contem o esqueleto de aplicações symfony; os módulos fazem o defeito; configuração de e, dados de i18n, diante do por do assim de e.
  • $doc_dir/symfony/contem um documentação.
  • $test_dir/symfony/contem testes de unidade.

Como os variáveis fazem o da PERA do configuração de são parte de sua do _dir. Valores do seus do ver de Parágrafos, seguinte datilografar de o: