Jak strukturovat kód PHP?

1.8.2006 14:17

Zdravím všechny,

uvítal bych nějaké názory na to, jak psát PHP kód. Chtěl bych se vyhnout/eliminovat zlozvyky, co při psaní kódu už mám . Dodržuje se nějaké RFC? Co si myslíte o tabulátorech při odsazování?

Stačí alespoň nasměrovat, když už tak ať to dělám pořádně.

Díky všem.

bl4z4

       

Komentáře

[Käyttäjä 11133]

Odsazovat jen a jedině tabelátry!!!! Taždý si je může pak nastavit jak chce.

[ajikdpoe]

Len by ma tak zaujimalo, nenajde sa tu niekto kto odsadzuje z pravej strany ??? ;)

[xxxxxxxx]

možná kdyby to ten niekto psal v hebrejstine

[Martin]

Proč jenom v hebrejštině? On by to nebyl problém ani normálně. I když takovýmu Pythonovi by se to asi moc nelíbilo :o)

[python2]

Tabelátory jsou humus, nejlepší a nejspolehlivější odsazování je 4 mezerami.

[Josef Kufner]

Proč?

[happy barney]

najlepsie odsadzovanie je take, ktore clovek robit nemusi, o ktore sa stara jeho editor/vyvojove prostredie.

Pravda, tabelatory su humus. A odpoved na otazku "preco": zalezi od coding style. Bezny je napr styl, ze argumenty funkcie sa zarovnavaju pod otvaraciu zatvorku. Tam treba dorovnavat medzerami.
Pripad 1: tabsize=8, odsadenie o 20 = 2x tab 4x medzera
Pripad 2: tabsize=4, odsadenie o 20 = 5x tab
Vysledok? prenos z 1 do 2 = odsadenie o 12, z 2 do 1 = o 40

Co sa tyka 4, to je priemer medzi 0 a 8, tak asi preto

[hm]

To zas bude flame s těma tabulátorama! Podle mě jsou fajn, protože člověk musí víc přemejšlet víc analyticky (= psát funkce zjednodušující problém), na druhou stranu to (občas děsně) zdržuje...

Důležitý jsou komentáře (i když úplně nejlepší sranda jsou komentáře tvrdící něco jiného než dělá kód ).

[VícNežNic]

Komentáře jsou nezbytná část kódu.

	
public void deleteUser (int Id) {
	//tahle funkce se mi libi a to jsem ji jeste ani nenapsal 

[bl4z4]

No flame please . Jde mi napr. o tohle:

if xxx
{
  xxx
}
else
{
  xxx
}

nebo

if xxx
 {
   xxx
 }
else
 {
   xxx
 }

nebo

if xxx {
xxx
} else {
xxx 
}

apod.

[hm]

Tak to je rada úplně jednoduchá - vyberte si styl co se vám líbí a dobře čte a pak ho dodržujte

[ajikdpoe]

A pretoze ziadny clovek nedokaze ani svoj vlastny styl dodrziavat, pouzivajte nejaky formatovac zdrojakov ala indent...

[Miloslav Ponkrác]

Teď jste mě urazil, já už osmnáct let svůj styl zdrojáků dodržuji a nemám s tím sebemenší problémy.

[Kyosuke]

Tehdy se ještě programovalo na předním panelu počítače, ne? Tam se špatně indentuje...

[Martin]

To bylo asi přece jenom o pár let dřív ;o)

[happy barney]

2006 - 18 = 1988, to uz boli "na trhu" "uzasne" PP06

[David Watzke]

if (xxx)
{
    xxx
} else {
    xxx 
}

[hm]

Má zrovna tenhle styl nějaké speciální výhody pro PHP?

http://en.wikipedia.org/wiki/Indent_style

[David Watzke]

Nemám tušení, v PHP umím jen echo a @include

[Hanato]

<flame>rekl bych ze lepsi je:

if (xxx) {
     xxx
} else {
     xxx
}
</flame>

[David Watzke]

Jo, to taky někdy používám. Tedy ne že by na tom záleželo

[Deleted [8409]]

já mám zase radši:

if (xxx) {
     xxx
}
else {
     xxx
}

No není to hezčí?

[David Watzke]

Ne, to není

[Michal Kubeček]

Tohle je typ dotazu, kde se ničeho jiného než flame dočkat nemůžete. To je jako se ptát, jestli KDE nebo Gnome, ATi nebo nVidia, ext3 nebo ReiserFS. Stačí se podívat do historie a hned je jasné, jak to dopadne. Ale přesto to čert ví proč pořád někdo zkouší…

[VícNežNic]

Hádat se v diskusi ujde, ale přesvědčovat Visual Studio, že na tom tabulátoru jako opravdu trvám (a na osmi znacích taky), to je teprve sranda. Ti zoufalci (minimálně v Express verzi) to v nastavení zakamuflovali co to dalo.

[bl4z4]

No, já jsem se dozvěděl, co jsem potřeboval. A to je to, že strukturování kódu je na mě. Pokud pro to neexistuje nějaké RFC, tak to už nemíním řešit. Jinak všem díky za reakci.

[Michal Kubeček]

RFC na to AFAIK není. Ale pokud byste chtěl spolupracovat na nějakém větším projektu, tak ty obvykle mívají předepsaný coding style, kterého je třeba se držet. Pokud něco tvoříte vy sám, zvolte si takový, který vám nejvíc sedí.

[Michal Kubeček]

Třeba tu prostřední variantu považuji (obzvlášť v kombinaci s odsazováním tabulátorem) za docela vražednou, ale někdo to tak má rád…

[ABCLinuxuIsAlive]

no ja to pisu takhle:
funkce:

public void funkce( String s )
{
}

Cykly a podminky (a bloky try {} catch {} finally {}):

if ( true ) {
}
else {
}

for ( int i = 0 ; i < 1 ; i++ ) {
}

Chytnul jsem to v nejake knizce o objektovem programovani a myslim, ze se to jmenuje nejak na "E", ale nemam ji tady, takze ti nepovim :)
Kazdopadne mi to takhle prijde nejpohodlnejsi a nejprehlednejsi, jak muze byt ..

Na odsazeni pouzivam samozrejme tabulatory, protoze jsou nastavitelne, takze si to kazdy muze zobrazit, jak je zvykly ..

[Michal Vyskočil]

Píšu to stejně, protože mám folding ve vimu přehlednější. Až na ty tabelátory, protože ty mám nastavené na 4 mezery

[Martin]

Rozhodně třetí případ s tím, že bych xxx ještě odsadil. Dřív jsem odsazoval o osm, pod tíhou argumentů kolegů z české konference jazyka Python jsem však přešel na odsazování o čtyři. A přestal jsem používat tabulátory, mezery mi teď přijdou nějak lepší. Ale tato otázka ještě není zcela vyřešena ;o)

[borama]

V knize Code Complete první případ mírně kritizovali - protože prý při pohledu "z rychlíku" (= s přimhouřenýma očima), kdy vnímáš jen odsazení řádků zleva a což ti má rychle odhalovat logickou strukturu programu, jsou tam ty řádky s těmi závorkami navíc/chybně.

Hodně preferovali třetí způsob, za předpokladu, že jsou ta vnitřní xxx odsazená.

Podle mě je OK cokoliv, ale hlavně ať je od začátku až do konce stejné!

[Miloslav Ponkrác]

Žádný standard neexistuje, pouze subjektivní názory. Já to ve všech jazycích dělám takto:

if (...)
{
}
else
{
}

function f(...)
{
}

class c
{
  function c()
  {
  } 
}

K odsazování používám zásadně mezery.

Nikomu svůj styl nevnucuji, ať si každý udělá svůj. Snad jen, že pořád nechápu, proč lidi preferují toto, podle mě je to daleko nepřehlednější, než výše. Ale asi je to z historických důvodů a pak si lidi zvyknou, ale možná, že jen něco nechápu:

if (...) {
}
else {
}

[VícNežNic]

No, já preferuji zásadně právě ten poslední uvedený (tedy, else bych dal hned za }). Proč? Protože to poznám podle odsazení a dělat zbytečný bordel tím, že { dám na samostatný řádek? Proč? Abych toho na jedné obrazovce viděl méně?

[Martin]

Souhlasím. Často jsou slyšet protiargumenty k tomu poslednímu zápisu (který taky používám), že je to údajně nepřehledné. Nepřehledné by to možná bylo bez odsazení, jinak je to myslím lepší. V případě že se odsazuje je i podle mě zbytečné dávat závorky na nový řádek. To je aspoň můj názor. Ať si každej používá co chce. Ale je fakt, že už jsem na to tak zvyklý, že v Mistrovství v C++, který jsem si před nedávnem pořídil a kde se používá ten první zápis, mi to už docela vadí.

[Michal Kubeček]

Osobně dávám také přednost

  if (x == 1) {
    y = 1;
  } else {
    y = 0;
  }

ale je tam jedno úskalí: pokud se z důvodu úspornosti nepoužívají bloky tam, kde je jen jeden příkaz, snadno se stane něco takového, jako že z

  if (x == 1)
    do_something();

uděláte

  if (x == 1)
    do_something();
    do_something_else();

Bohužel to někdy nemusí být tak očividné, třeba

  if (x == 1)
    if (y == 1)
      do_something();
  else
    do_something_else();

[VícNežNic]

Proto jsem taky tuhle věc udělal pokud si pamatuju jenom jednou jedinkrát. Kdepak asi

[zelial]

tenhle je i muj oblibeny. chvili trva, nez si clovek zvykne, ze otevirajici a uzavirajici zavorky nejsou pod sebou.

ale je pak videt vice kodu na jedne obrazovce a imho to kod zprehledni vic nez zarovnane zavorky.

navic je to nejkompaktnejsi zapis jaky znam, takze mi s nim nedela problem nepouzivat if-y bez zavorek - vyhnu se tomu uskali ;)

[happy barney]

a preto treba pouzivat reindentovacie nastroje, popr emacs a jeho hungry programmer mode

[Dalibor Smolík]

snad bych dal raději

if ((x ==1) && (y==1)) {
do_someting();
}else{
do_semeting_else();
}

[Michal Kubeček]

Bez toho odsazení bych se v tom nevyznal. Ale jak praví klasik, proti gustu žádný dišputát.

[moira]

pokud se z důvodu úspornosti nepoužívají bloky tam, kde je jen jeden příkaz

Z vlastni bolestne zkusenosti vim, ze setrit na nespravnem miste se nevyplaci... :)

[Josef Kufner]

Jojo, taky píšu závorky všude. Pak je tenhle způsob velice pohodlný...

[MEDss]

< FLAME > taky sem to tak valil tim druhym, prislo mi to hrozne profi.. zavorky na samostatny radek to je pro decka jenze tak po pul roce prochazeni kodem ( cti kodenim ) sem zjistil ze se strasne tezko dohledavaji zacatky a konce bloku ( snadno se to prehledne ) tak sem to pak vsecko prepsal na ten prvni zpusob mozna je to detinske ale o to prehlednejsi
ad k tomu ze je videt vic radku??? ja kdyz neco pisu tak pisu jen jeden radek,vy snad kodite na vice radcich na jednou :))))
a pak kdyz dokodim a dam si wc tak mam lepsi pocit s toho ze sem nakodil vic radku < /FLAME >

[Martin]

sem zjistil ze se strasne tezko dohledavaji zacatky a konce bloku

Když budu odsazovat, tak se tomuhle problému vyhnu ne? V Pythonu nejsou závorky vůbec a čitelnost kódu to nijak neztěžuje, ba úplně naopak.

Takže když člověk správně odsazuje, tak je jedno jestli ty závorky prdne na konec řádku nebo na samostatný řádek.

[VícNežNic]

No, můj výzkum & vývoj na téma odsazujeme a formátujeme ve Smalltalku byl zatím zcela neúspěšný

[Martin]

Se Smalltalkem jsem ještě neměl tu čest, ale legendy o něm hovoří ledacos. Někdy se s ním budu muset zkamarádit. Nebo se o to alespoň pokusit. Zatím totiž stále ještě patřím mezi programátory, "kteří to ještě nepochopili." :o)

[VícNežNic]

K této skupině se mohu hrdě hlásit doposud Uvidíme, až přijdu na nějaký rozumný způsob jak to odsazovat

[Michal Vyskočil]

Metoda s více jak 7 řádky je příliš velká ... no a na těch 7 řádcích nějaké odsazení nemá vcelku cenu řešit

[VícNežNic]

Největší, no, možná jediný problém je v oblasti [bloků kódu]. Jako tady v PHP

[Michal Vyskočil]

Co tohle?

[Michal Kubeček]

k tomu ze je videt vic radku??? ja kdyz neco pisu tak pisu jen jeden radek,vy snad kodite na vice radcich na jednou

Ano, osobně dávám přednost tomu, abych viděl pokud možno celou funkci, kterou právě upravuji, pokud uvidím i něco navíc, tím lépe.

[MEDss]

bud větší monitor nebo kratší funkce :)))))))))))))

ja su svina

[Michal Kubeček]

Zatím je mi líto investovat do něčeho většího než 20-palcové LCD s rozlišením 1600x1200… :-(

[MEDss]

jako ale bylo by to paradni mit nejake to 24palcove LCD ze? ještě tak širokouhlé otočné ( vertikálně na kodění, horizontálně na filmy ) to bych si nechal líbit.. nenašel by se tady někde sponzor nadějného programátora? ))

stačilo by: http://www.svethardware.cz/art_doc-991A15A26E53556EC12571A9003B647C.html

kdyžtak mě pak kontaktujte na me emailové adrese

[happy barney]

a co tak 20tka LCD 1680x1050 otocena o 90 stupnov ? zobrazenych 140 riadkov + emacsovske prkotinky

[VícNežNic]

Napadlo mě, lze monitor zvětšovat donekonečna? Nejde o to, jestli to jde technicky, ale člověk nemůže najednou vidět neomezenou plochu a příliš malá (vzdálená) písmenka by už taky vidět nemohl.

Kde je tedy hranice největší najednou viditelné funkce? (průměrně, pochopitelně)

[Michal Kubeček]

To by se asi nejdřív muselo definovat, zda má být najednou viditelná bez pohybu očí, bez pohybu hlavy, bez nutnosti vstát ze židle atd. Pak by se musela určit standardní čtecí vzdálenost, velikost pohodlně rozeznatelného písma při této vzdálenosti a velikost pohodlně pozorovatelné plochy. Zatím mne uklidňuje, že rezervy tu určitě jsou. Když jsem na PC začínal, měl jsem v editoru nějakých 22 řádků (Turbo Pascal 5), teď je to v kate 62, ale kdyby bylo víc, nepohrdl bych. Asi zkusím vyzkoumat, jak je to s tím otáčením monitoru, když už tu funkci má…

[blogsm]

Od toho je projektor. Záleží jak je velká zeď.

[Michal Kubeček]

Projektor problém příliš neřeší, protože na zdi musejí být písmenka větší. Leda že bych seděl těsně před zdí, ale pak bych si asi trochu stínil. Navíc by projektor s tak jemným rozlišením byl nejspíš dražší než pět monitorů nad sebou…

[happy barney]

vim obsahuje klavesovu skratku % (chod na protilahlu zatvorku).
emacs ma nieco podobne (pouzivam premapovanie na %, takze neviem default nastavenie), navyse v modeline zobrazuje riadok, na ktorom sa zatvorka nachadza. A v takom pripade je urcite vyhodnejsie, ak sa zobrazi napr

if (strasna_podmienka) {

oproti samostatnej zatvorke

este ze vsetci pozname indent

[Dalibor Smolík]

if (...) {
}
else {
}

Jo, tak to jsem přesně já

[Leoš Literák]

Ja bych preferoval, kdyby PHPkari strukturovali kod tak, aby oddelili logiku od prezentace. Sam si pamatuji na ten svuj bastl zvany Linux Hardware, co bezel na penguinovi.

[blogsm]

Já když píšu html, tak to píšu jak se mi hodí. A když se v tom nevyznám tak hodím nějakej automatickej formát a je to...

[Luk]

Já pro PHP preferuji styl GNU, tedy v zásadě tento (který se snažím dodržovat i pro C/C++ ).

[Pavel 'lingeek' Szalbot]

Zend coding style. Osobně mám rád coding style GNU a Javy. Svého času mi imponovala maďarská notace pro C, ale to už je jiná kapitola (a zpětně už hodnotím hůře než vlažně)....

[Luk]

Pro Javu javovský, pro ostatní (C, C++, PHP) styl GNU

[diverman]

A jak píšete víceřádkové komentáře?

/**********
 * blabla *
 **********/

/*
 * blabla
 *
 */

A jednořádkové?

/* blabla */

// blabla

[Michal Kubeček]

/*
  bla
  bla
*/

// blabla (odsazeno podle kontextu)

[Josef Kufner]

Hvězdičky na každém řádku hodně pomáhají – dobře zvýrazní co ještě je komentář. Navíc vim umí s těma hvězdičkama zacházet jakoby tam nebyly...

[Michal Vyskočil]

A navíc mi je tam automaticky doplňuje, tak proč nemít "hezké" zdrojáky

[Michal Kubeček]

Asi už jsem si moc zvykl na editory, které zvýrazňují syntaxi…

[happy barney]

zvyraznovanie/nezvyraznovanie, grep je argument

[David Watzke]

Ten první jen na nadpis

[Josef Kufner]

/*******************************************
 * Nadpis druhe urovne (funkce)
 */

[Jiří Němec]

PHPeclipse Ctrl+Shift+F.