Organização dos Arquivos

O nome de um arquivo Perl deve conter uma das seguintes extensões:

.pl – para programas escritos em Perl
.cgi – para programas Web independente de linguagem

As convenções de código dizem que o arquivo de código-fonte deve ser composto de seções separadas por linhas em branco juntamente com um comentário identificando cada seção.

Não é recomendado fazer arquivos que excedam 2000 linhas de código, pois isto pode gerar incômodo ao programador, além de dificultar sua compreensão.

Para padronizar a estrutura dos arquivos de código-fonte, devemos seguir algumas regras.

1. Deve-se iniciar o programa informando o local do interpretador
2. Começa o arquivo de código-fonte com comentários introdutórios
3. Faz a declaração dos pacotes usados (use)
4. Em seguida, faz-se a declaração do que primeiro aparecerá ao usuário
5. Os comentários introdutórios devem seguir o estilo Linux de programação, contendo a data, a notícia de copyright e uma breve descrição do propósito do programa.
6. Os pacotes devem ser as primeiras declarações não-comentadas do código.
7. Antes de declararmos cada tela que aparecerá ao usuário, podemos fazer um comentário descritivo sobre a mesma. Depois de colocarmos a tela, podemos comentar sobre como implementá-la, se necessário.

Para declararmos as variáveis devemos seguir a seguinte ordem:

1. As estáticas devem ser declaradas primeiramente
2. E por ultimo os métodos genéricos.

Os métodos devem ser agrupados por funcionalidade, e não por escopo ou acessibilidade.

Não importa se um método de classe privada tiver no meio de dois métodos públicos. O objetivo é tornar o código mais legível e compreensível.

Perl Code Conventions
[ 1 | 2 | 3 | 4 | 5 | 6 ]