Como instalar no Ubuntu PhpDocumentor
Todos nós sabemos que é importante escrever documentação para o nosso código. Não é o aspecto mais emocionante da programação, mas infelizmente ela é necessária para aqueles momentos em que temos de corrigir ou mudar algo de seis meses após escrevê-lo e não tenho lembrança de como o código funciona, ou talvez de escrevê-la em tudo. Felizmente, existe ajuda na mão, você pode documentar muito do seu PHP código semi-automaticamente com uma ferramenta útil chamado PhpDocumentor . Se você tiver programado em Java antes e utilizado Javadoc isso será muito familiar para você. Não está prontamente disponível pré-embalados com apt , mas felizmente é razoável simples de instalar.
A idéia de PHPDocumentor é a utilização de tags em comentários especialmente formatados em seu código para documentar o que está acontecendo, por exemplo, você pode um documento que faz uma função, seus parâmetros e que tipo de variável ele retorna. PHPDocumentor, então, ler através de seu código e extrair essas informações para criar um arquivo HTML ou PDF contendo esta informação em um fácil de usar significado formato que você pode encontrar essas informações novamente sem ter que olhar através de um monte de código. Seu código pode ser algo como isto com as informações extra adicionado:
/ **
* Verifique o nível de estoque para um item número
* @ param int $ item_number Seis número de estoque dígitos como o usado por lojas de departamento
* @ return int Número de itens em estoque
* /
função get_stock_level ($ item_number) {
/ / algum código
de retorno $ stock_level;
}
Observe o asterisco duplo (isto diz PhpDocumentor deve extrair informações a partir deste bloco) no bloco de comentário eo @ param e @ return etiquetas descrevendo o que é esperado pela nossa função eo que é que vai sair. Há lotes de tags disponíveis e você pode gerar documentação bastante detalhada para o seu código. Para uma lista completa e um tutorial ter um olhar para o manual PhpDocumentor em: http://manual.phpdoc.org/ .
PhpDocumentor é escrito em PHP e é projetado para ser usado através de um navegador para configurar suas muitas opções. Ele também vai precisar de um local gravável pelo servidor web onde se pode colocar os arquivos que ele gera para o seu projeto. O primeiro passo é ter certeza de que o PHP eo Apache web server já instalado em sua máquina de desenvolvimento. Se você estiver escrevendo código PHP é muito provável que você já fez isso! Se não entrar neste em um terminal (Apache é uma dependência do libapache2-mod-php5 pacote para que ele será instalado automaticamente):
sudo apt-get install libapache2-mod-php5
Reinicie o Apache para ter certeza que ele pega a instalação do PHP (caso contrário você pode encontrar o seu browser irá pedir-lhe para baixar o arquivo PHP não sendo executado no servidor!):
sudo / etc/init.d/apache2 restart
Ao invés de fazer um download manual e instalar teremos PhpDocumentor através PEAR , que é um repositório de extensões PHP. Vamos precisar de instalar o pacote php-pear primeiro a tornar isso possível:
sudo apt-get install php-pear
Por padrão o Apache irá olhar para o /var/www do diretório de conteúdo web para antes da instalação devemos dizer PEAR que esta é onde queremos ir PhpDocumentor:
sudo pear config-set data_dir /var/www
Agora podemos instalar PhpDocumentor e também todas as dependências ele precisa:
sudo pear install -alldeps PhpDocumentor
Antes de utilizar PhpDocumentor nós precisamos fazer um diretório de saída. Você também pode colocar isso sob o diretório / var / www, eu vou usar um nome de "PhpDocumentor-saída":
sudo mkdir /var/www/PhpDocumentor-saida
Nós também precisamos mudar o dono deste diretório para www-data como esta é o nome de usuário é executado no Apache e, portanto, só pode PhpDocumentor saída para os diretórios onde este usuário tenha permissão de escrita:
chown sudo www-data/var/www/PhpDocumentor-saida
Se você navegar para http://localhost/PhpDocumentor/ (note que a URL é case sensitive) você vai encontrar a instalação pronto para ser executado. Na aba Arquivos de entrar no arquivos que você deseja gerar a documentação de. Em caixa na guia Saída-alvo colocar / var / www / PhpDocumentor-output / e depois adicionar o nome do seu projeto, por exemplo / var / www / PhpDocumentor-output / myproject . Você pode adicionar formatos de saída você deseja gerar, selecionando-os na caixa suspensa e clique em Adicionar o conversor na ajuda caixa. Se você clicar no Criar botão a documentação deve ter gerado e você será capaz de navegar para o resultado, indo para:http://localhost/PhpDocumentor-output/ . Você pode, naturalmente, copiar os arquivos resultantes do diretório de saída e publicá-los onde quiser.
Xo สล็อตออนไลน์ โปรสล็อต XO เกมออนไลน์ทำเงินยอดฮิตเกมสล็อต xopg.net คือเกมทำเงิน reeffutures2018 ผ่านทางออนไลน์อย่างหนึ่ง ที่เล่นง่าย และได้เงินไว แถมยังลงทุนด้วยเงินน้อย mavoixtavoie ทำเงินได้ตลอดเวลา ซึ่งหลายคนอาจได้เคยเห็นรีวิวเรื่องของ สล็อต xo สล็อตออนไลน์ ไว้มากมาย เทคนิคสล็อต ทั้งเรื่องการเล่นแล้วได้เงิน herbalpertpresents และเล่น สล็อต แล้วไม่ได้เงิน นั่นเองค่ะ ซึ่งการที่คุณจะเล่นได้เงินหรือไม่ได้เงินนั้น essentialsforasoul ส่วนหนึ่งก็เป็นในเรื่องของดวงเข้ามาเกี่ยวด้วย northbristol เพราะสล็อตเป็นเกมออนไลน์เสี่ยงโชค ทดลองเล่น xo เกมหนึ่งซึ่งจะมีสูตร หรือเทคนิคเข้ามาช่วย gclub เพื่อโกงดวงอยู่เสมอซึ่งในเว็บของเรา สมัคร xo ก็มีมาแนะนำไว้ให้เห็นกันมากมายหลายสูตร
