-1

Padrões de Programação PEAR (parte 2)

criado por Marcelo Pereira Fonseca da Silva em 27/02/2004 11:11am
Falaremos agora como trabalhar com chamada de funções
dentro do seu script PHP.

O padrão especificado é o que segue:

"Funções devem ser chamadas SEM espaços entre o nome da função,
o parênteses de abertura e o primeiro argumento, os demais argumentos
devem conter um espaço entre ele e a vírgula anterior"

Supondo a seguinte situação:

Tenho uma função chamada "melancia" na qual passo 3 argumentos

<?php
$variavel = melancia($cor, $valor, $peso);
?>

Esta seria a maneira correta de usar a função descrita acima.

Mudando um pouco de assunto um ponto necessário em qualquer
programação são as variáveis, e para usá-las naturalmente há uma
maneira de deixar sua leitura mais fácil.

"Use espaços para igualar o sinal que atribui valor às variáveis"

Vamos ao exemplo:

<?php
// supondo um script...
$cor = "amarelo";
$tamanho = "gigante";
?>

Este código inicialmente parece correto, mas poderia ser melhorado
usando o padrão especificado pelo pessoal da PEAR

<?php
// supondo um script...
$cor     = "amarelo";
$tamanho = "gigante";
?>

Assim fica bem mais fácil a leitura de variáveis dentro do seu script

Comentários:

Mostrando 1 - 10 de 22 comentários
Ótimo artigo, esses padrões irão ajudar a organizar meus códigos, vlw... obrigado pelas luz... apresentareis aos programadores da equipe aqui...

abraço...
14/09/2007 10:10am (~9 anos atrás)

Cara, muito bom o artigo...
Fora essas criticas sem sentido, tem que explicar para eles que padrão é bem diferente de regra.

Seguir o padrão da PEAR acredito ser a melhor escolha, por ser a melhor biblioteca para php.

[]'s
13/07/2006 12:46pm (~10 anos atrás)

Eu sigo algumas regras do padrão PEAR até por questões de estética do código, o código fica mais limpo e bem mais fácil de se entender. Porém, cada programador tem sua regra e forma de programar do jeito que achar melhor, a PEAR setou um padrão adotado pela grande maioria e não por todos, alguns até tentam se adaptar mas quase nunca consegue ou demora um certo tempo. Minha opinião é que cada programador deve utilizar seu próprio metodo, com tanto que se obtenha o resultado esperado no final.

Abraços!
17/06/2005 9:08am (~11 anos atrás)

... stress.

Eu particularmente uso o SciTE para editar meus PHP's. Eu configurei ele para que quando eu teclar o TAB ele use quatro espaços. Simples huh? :)

[z]
25/03/2004 2:19pm (~12 anos atrás)

não existe minha regra
o tema do artigo não é sobre REGRAS DO MARCELO

SIGA OU MORRE!

ninguém nunca falou isso aqui, dos 15 comentários todos foram produtivos

Se você não concorda, bom, tudo bem
Só que o artigo volto a dizer..

não é e nunca será sobre regras que eu quero impor.. eu não quero impor nada..

Isso são padrões da PEAR que EVENTUALMENTE é ACONSELHÁVEL usar

o caps lock nas duas palavras acima é para dar ênfase no intuito do artigo

sei que muitos detestam a PEAR, outros gostam da PEAR mas não usam os coding standards dela.. o conteúdo é só pra dar uma chance do pessoal conhecer alternativas para melhorar seus códigos (quem quiser, obviamente)
10/03/2004 2:15pm (~12 anos atrás)

João K. disse:
"eu que não vou ficar alterando meu editor toda hora"

a sua regra também deveria se aplicar a isso.
10/03/2004 2:03pm (~12 anos atrás)

Para chamada de funcoes e estruturas de controle if, else, switch, while etc..

a PEAR poe no manual o

if (condicao) {
//codigo
}

para definicao de funcao, ou seja:

function lalala($lerolero)
{

}

isso vale também para classes

espero ter ajudado
08/03/2004 9:59am (~12 anos atrás)

Ígor Bonadio disse:
Uma dúvida: tb está certo usar assim:
if (condição)
{
//codigo
}
ou deve ser assim:
if (condição){
//codigo
}
E isso serve tb para funções?
07/03/2004 7:38pm (~12 anos atrás)

a questão não é o melhor estilo
a questão era achar um comum
já que é homologado pela php.net

é triste ver comentários contra
não porque eu ou a PEAR ou seja la quem for quer impor algo.

Mas porque quem sofre depois é o próprio programador, que sempre precisa trabalhar em cima de scripts assim..

o uso de comentario com tab particularmente acho que não funciona.

eu que não vou ficar alterando meu editor toda hora
07/03/2004 9:14am (~12 anos atrás)

João K. disse:
Eu uso TAB sem dó nem piedade huahuahua. E quero ver quem me convence do contrário.

uma maneira de contornar o problema é só acrescentar um comentário no topo do script informando quanto um TAB vale de espaço.
exemplo

// 1 TAB = 4 blank space


Programming Style Tips
http://area51.phpbb.com/docs/guide-standards.html
http://www.cs.sonoma.edu/~tiawatts/C++Style.html
http://www.possibility.com/Cpp/CppCodingStandard.html
http://geosoft.no/style.html



Realmente no fim é uma Guerra Santa para dizer o melhor ESTILO....
07/03/2004 1:39am (~12 anos atrás)

Novo Comentário:

(Você pode usar tags como <b>, <i> ou <code>. URLs serão convertidas para links automaticamente.)