Standardy kodowania [scanner] |
Standardy kodowania [scanner] |
29.04.2004, 08:43:12
Post
#21
|
|
Grupa: Zarząd Postów: 3 503 Pomógł: 28 Dołączył: 17.10.2002 Skąd: Wrocław |
Cytat Rozumiem, że ogólnie przyjęte jest stosowanie nazw fuckcji, zmiennych w języku angielskim ale Polacy nie gęsi ) ... tym bardziej że komentarze są w języku ojczystym . O ile przetłumaczenie komentarzy dla potrzeb publikacji skryptu na serwisach obcojezycznych to nie jest większy problem o tylko zamiana w skrypcie[php:1:b819e79dc8]<?php
MojaFunkcja() ?>[/php:1:b819e79dc8]na [php:1:b819e79dc8]<?php MyFunction() ?>[/php:1:b819e79dc8]już takie problemy nastręcza szczególnie w przypadku bardziej rozbudowanych aplikacji. Pozatym anglikowi czy francuzowie wiecej powie[php:1:b819e79dc8]<?php $objDBDriver->Query() ?>[/php:1:b819e79dc8]niż[php:1:b819e79dc8]<?php $objSterownikBazy->Zapytaj() ?>[/php:1:b819e79dc8] -------------------- |
|
|
29.04.2004, 11:25:25
Post
#22
|
|
Grupa: Zarejestrowani Postów: 5 Pomógł: 1 Dołączył: 20.06.2002 Ostrzeżenie: (0%) |
Cytat O ile przetłumaczenie komentarzy dla potrzeb publikacji skryptu na serwisach obcojezycznych to nie jest większy problem o tylko zamiana w skrypcie [...]
Chodzi mi o to że większość programistów polskich zna chociaż podstawowo angielski, po prostu są zmuszenie do tego. Tak się zastanwiam dlaczego nie zmusić reszty świata do uczenia się polskiego Ja równięż używam nazw angielskich, bo czasem trudno znaleść odpowiedniki np query = kwerenda W sumie moj post był pewnego rodzaju prowokacją -------------------- ---
Pozdrowienia Marko |
|
|
30.04.2004, 08:04:50
Post
#23
|
|
Grupa: Przyjaciele php.pl Postów: 701 Pomógł: 0 Dołączył: 26.06.2002 Skąd: Londyn Ostrzeżenie: (0%) |
@shima: jeszcze cos dla Ciebie http://www.jwz.org/doc/tabs-vs-spaces.html
-------------------- |
|
|
30.04.2004, 13:54:33
Post
#24
|
|
Grupa: Zarejestrowani Postów: 245 Pomógł: 0 Dołączył: 9.09.2002 Ostrzeżenie: (0%) |
Cytat @shima: jeszcze cos dla Ciebiehttp://www.jwz.org/doc/tabs-vs-spaces.html
Coż, jako że w mojej grupie wszyscy używamy tego samego narzędzia, więc nie zdawałem sobie sprawy z powagi sytuacji, ale ten artykuł wyjaśnił mi kilka kwestii. Część merytoryczna warta jest polecenia każdemu, kto pracuje w zespole. THX wassago -------------------- Nie ma nic stałego prócz zmiany...
|
|
|
2.05.2004, 12:12:22
Post
#25
|
|
Grupa: Zarejestrowani Postów: 33 Pomógł: 0 Dołączył: 20.03.2004 Ostrzeżenie: (0%) |
Bardzo fajny artykuł, na pewno wykorzystam niektóre punkty.
Do tej pory starałem się trzymać standardów PEARa, więc nie bardzo rozumiem jednej rzeczy: po co dodawać nadmiarowe spacje na początku i końcu listy argumentów dla funkcji oraz instrukcji for, if, switch, while? Moim skromnym zdaniem nie zwiększa to jakoś specjalnie czytelności kodu, a stanowi dodatkowy wysiłek dla programisty (i tak już przemęczonego ). Na dodatek nie jest zgodne ze stanadardem PEAR. Myślę że spokojnie możnaby obyć się bez tego wymagania. -------------------- dehumanization in progress
|
|
|
4.05.2004, 22:47:15
Post
#26
|
|
Grupa: Zarejestrowani Postów: 270 Pomógł: 0 Dołączył: 15.06.2003 Ostrzeżenie: (0%) |
Spoko artykulik ale brakuje paru rzeczy
Bardzo fajnie byłoby pokazać jak zbudowac domumentacje kodu poprzez phpDocumentator. Np pare screenów. Wówczas będzie potrzebne @package i @subpackage oraz jak powinnien wyglądać poprawnie skomentowany plik i klasa. W liście wolnych art nie było o phpdoc wiec chyba można w tym go troche lepiej opisac |
|
|
5.05.2004, 17:35:36
Post
#27
|
|
Grupa: Zablokowani Postów: 655 Pomógł: 0 Dołączył: 28.11.2003 Skąd: Zagórz Ostrzeżenie: (80%) |
ja niewiem po co przy nazwach zmiennych pisac jej typ ?
-------------------- |
|
|
5.05.2004, 17:42:58
Post
#28
|
|
Grupa: Zarząd Postów: 3 503 Pomógł: 28 Dołączył: 17.10.2002 Skąd: Wrocław |
Po to, żeby się nie pogubić i uczynić kod czytelniejszym. Lepij chyba jest, jak widac jaki typ danych w srodku siedzi, co nie?
-------------------- |
|
|
5.05.2004, 19:02:17
Post
#29
|
|
Grupa: Przyjaciele php.pl Postów: 701 Pomógł: 0 Dołączył: 26.06.2002 Skąd: Londyn Ostrzeżenie: (0%) |
Cytat Spoko artykulik ale brakuje paru rzeczy
Bardzo fajnie byłoby pokazać jak zbudowac domumentacje kodu poprzez phpDocumentator. Np pare screenów. Wówczas będzie potrzebne @package i @subpackage oraz jak powinnien wyglądać poprawnie skomentowany plik i klasa. W liście wolnych art nie było o phpdoc wiec chyba można w tym go troche lepiej opisac spoko, o tym powstanie calkowicie oddzielny art (by me) :wink: zaczne go pisac po maturach (ok. 20.05.2004) EDIT: nie phpDoc (przestarzaly, od 3 lat brak aktualizacji), tylko phpDocumentator :wink: -------------------- |
|
|
5.05.2004, 20:20:10
Post
#30
|
|
Grupa: Zarejestrowani Postów: 270 Pomógł: 0 Dołączył: 15.06.2003 Ostrzeżenie: (0%) |
bajer. phpdoc jest bardzo fajnym standardem komentowania kodu i warto go w pełni wykorzystac.
|
|
|
1.06.2004, 11:56:56
Post
#31
|
|
Grupa: Zarejestrowani Postów: 215 Pomógł: 0 Dołączył: 18.01.2003 Ostrzeżenie: (0%) |
ja troszeczke inaczej definiuje zmienne. szkoda mi tylu znakow (trzy) marnowac.
i tak: [php:1:496cc18713]<?php $intVar -> $iVar $strVar -> $sVar $arrVar -> $aVar $objSmarty -> $oSmarty $blnVar -> $bVar $resFile -> $rFile $fltVar -> $fVar ?>[/php:1:496cc18713] podobnie z petlami nie stosuje if ( expr ) { ... { tylko if( expr ){ ... } tego sie juz nauczylem z symfonii c++ "Jako wcięć powinno się używać 4 (czterech) spacji" ja uzywam 2 scanner napisal: [php:1:496cc18713] "<?php MyFunction( ); $objDBDriver->Query() ?> " [/php:1:496cc18713] ja z "thinking in java" nauczylem sie nawyku nazywania wszystkich funkcji i metod od malej litery a nazwy klasy od duzej np. [php:1:496cc18713] "<?php getSomething( ); $oVar->query(); class ClassName{} ?> " [/php:1:496cc18713] to tyle jesli chodzi o mnie... -------------------- Działam w OpenSolution.org, autor Quick.Cms i Quick.Cart już od ponad 10 lat
|
|
|
1.06.2004, 12:30:31
Post
#32
|
|
Grupa: Zarząd Postów: 2 277 Pomógł: 6 Dołączył: 27.12.2002 Skąd: Wołów/Wrocław |
tak przygladając się różnym standardom, również doszedłem do wniosku, że przydałoby się przeprowadzić parę modyfikacj. Może nie tak dalko posuniętych, ale jednak.
1. Klasy - zaczynamy od dużej litery, funkcje od małej 2. spacje - tylko w nawiasach - nie przed nimi, czyli powinno być [php:1:0258201679]<?php function test( $Param ) { if( $Cos ) { } } ?>[/php:1:0258201679] 3. nazwy obiektów. Wzorem innych języków - proponowałbym pominąć przedrostek obj, i nazywać je z wielką literą na początku, czyli [php:1:0258201679]<?php $Test = new Test; $Test->Input = new Input; ?>[/php:1:0258201679] -------------------- "Niezależnie od tego, jakie masz osiągnięcia, ktoś Ci pomaga..."
|
|
|
1.06.2004, 12:38:15
Post
#33
|
|
Grupa: Zarejestrowani Postów: 215 Pomógł: 0 Dołączył: 18.01.2003 Ostrzeżenie: (0%) |
ad2. fakt nie zauwazylem ... ja nie praktyktuje czegos takiego jak if ( cos ) ale if( cos )
ad3. mnie sie podoba bardziej $oObject a nie $Object -------------------- Działam w OpenSolution.org, autor Quick.Cms i Quick.Cart już od ponad 10 lat
|
|
|
2.06.2004, 12:34:18
Post
#34
|
|
Grupa: Zarejestrowani Postów: 866 Pomógł: 32 Dołączył: 2.06.2004 Skąd: Wrocław Ostrzeżenie: (0%) |
Nie mam może duzego doswiadczenia ale dla mnie o wiele bardziej czytelne jest takie "spacjowanie" funkcji:
[php:1:24f3721992]<?php date (Y-M-D); ?>[/php:1:24f3721992] niż: [php:1:24f3721992]<?php date ( Y-M-D ); ?>[/php:1:24f3721992] Natomiast przy tak krótkich argumentach w funkcjach jak "date()" wogóle pomijam spacje dla czytelnosci kodu. Może to wynika z tego że używam edytora który dobrze "koloruje" kod php. A poza tą jedną uwagą uważam, że ten Art jest świetny, klaruje wiele rzeczy dotyczących czytelności. ?>[/php] -------------------- |
|
|
2.06.2004, 12:49:20
Post
#35
|
|
Grupa: Zarząd Postów: 3 503 Pomógł: 28 Dołączył: 17.10.2002 Skąd: Wrocław |
Ja może powtórzę jeszcze raz, bo chyba nie wszyscy zrozumieli.
Komentowany materiał nie jest moim widzimisie, tylko dokumentem, który powstał w trakcie dyskusje developerów php.pl tuż po uruchomieniu prac nad projektem Thot. Zatem nie chodzi o to, kto jak woli, ale jak My, developerzy chcemy mieć ułożony kod. Przy okazji, pragniemy ustandaryzować niektóre działania, bo czytelność kodów prezentowanych na forum woła o pomstę do nieba. Każdy ma jakies swoje przyzwyczajenia. Ale jeśłi ich nie ma, jełsi zaczyna, to niech nabiera tych "ustandaryzowanych". -------------------- |
|
|
2.06.2004, 13:08:06
Post
#36
|
|
Grupa: Przyjaciele php.pl Postów: 701 Pomógł: 0 Dołączył: 26.06.2002 Skąd: Londyn Ostrzeżenie: (0%) |
Cytat [...]Przy okazji, pragniemy ustandaryzować niektóre działania, bo czytelność kodów prezentowanych na forum woła o pomstę do nieba. [...]
aaamen! :wink: -------------------- |
|
|
2.06.2004, 13:22:33
Post
#37
|
|
Grupa: Zarejestrowani Postów: 866 Pomógł: 32 Dołączył: 2.06.2004 Skąd: Wrocław Ostrzeżenie: (0%) |
Zgadzam się z tym, że jest to standard który jest przez was wymagany. Rozumiem to i akceptuje, wysyłając wszelkie pracę do was będzio on przeze mnie stosowany. Co więcej cieszę się że istniej, przynajmniej tutaj standard zapisu kodu.
Ale nadal będę twierdził że za duzo spacji wcale nie sprawia że kod jest przejżysty. Hmm... Może to przyzwyczajenia z informatyki? -------------------- |
|
|
2.06.2004, 13:59:17
Post
#38
|
|
Grupa: Zarejestrowani Postów: 569 Pomógł: 0 Dołączył: 17.08.2003 Skąd: Dąbrowa Górnicza Ostrzeżenie: (0%) |
Panowie, co ma spacja do czytelnosci kodu ? No tak jesli ktos nie uzywa entera to tak, przyda sie. ale spacjowanie wszystkiego co popadnie to jest troche nadgorliwosc, bo jak widze ser szwajcarski to glodny sie robi i nie czytam juz dalej.
Wazniejsze jest zeby kozystac z tabulacji przy wszelkiego rodzaju petlach, warunkach i innych miejscach gdzie przyda sie odruznienie kodu od siebie. [php:1:92376daa8d]<?php //tak ? function funkcyjka() { //... } //czy tak ? function funkcyjka2 ( ) { //... } $a=$b+$c; // czy $a = $b + $c; mysql_query ( " SELECT * FROM t1 WHERE col1 = ' " . $cos . " ' " ); //czy mysql_query("SELECT * FROM t1 WHERE col1 = '".$cos."'"); ?> to jest obojetne, czesc sie lepiej, czesc gorzej czyta, ale nie robmy czegos takiego: <?php funkcja funkcyjka() { /*...*/ } $a=$b+$c; mysql_query ("SELECT * FROM t1 WHERE col1 = '".$cos."'"); echo "ala ma kota, a kot ma ospe"; str_replace('c', 'a', $nic); echo $nic; ?>[/php:1:92376daa8d] a co do komentarzy to juz inna sprawa ze to przy publikacjach otwartych jest bardzo wazna rzecza zeby poprawnie udokumentowac/skomentowac kod. Nikt nie jest nieobylny i popelnia bledy, a przy ladnie napisanym kodzie duzo ladniej jest poprawic jakis blad, nie tylko obcej osobie, ale samemu. dla osob ktore maja problemy z ladnym pisaniem polecam bardzo ciekawa stronka i zarazem skrypcik jaBeautify php do pozadkowania kodu. Sam czasami kozystam w niektorych sytuacjach. -------------------- Warsztat: Linux: PHP, MySQL, Apache, NetBeans, C++, Qt-Creator
Użytkownik, słowo którego specjaliści IT używają, gdy chcą powiedzieć idiota Zarządzaj swoim budżetem domowym |
|
|
2.06.2004, 14:17:12
Post
#39
|
|
Grupa: Zarejestrowani Postów: 215 Pomógł: 0 Dołączył: 18.01.2003 Ostrzeżenie: (0%) |
Scanner napisal:
"Każdy ma jakies swoje przyzwyczajenia. Ale jeśłi ich nie ma, jełsi zaczyna, to niech nabiera tych "ustandaryzowanych"." Tak tylko niektorzy tez czytali jakies inne ksiazki nie tylko do php np. do Javy gdzie nie raz podawano za dobry przyklad pisania funkcji z malych a klas z duzych ... i to nie jest moje widzimisie bo napisalem od razu, ze co do nazewnictwa duzo bralem na wzor z Thinking in Java Jesli sie przypatrzec temu co napisaliscie apropo PHPdoc czyli np: @author @version to chce zauwazyc, ze takie cos juz od dawien obowiazuje np. w JAVA i nie tylko w PHPdoc (ktorego tworcy zapewne skorzystali z pomyslu i dobrze). Wiec skoro sa pewne teoretycznie "standardy" pisania w JAVA to czemu w php tego tez nie zastosowac? No chyba, ze chcecie sie na tyle wyrozniac ... Oczywiscie nie naciskam bo kazdy pisze jak chce ale zauwazcie iz to WY w bezposredni sposob tworzycie nowe trendy, style, standardy dla duzej grupy ludzi piszacych i zaczynajacych i dlatego pisze swoje widzimisie bo idealny nikt nie jest i uwagi moze przyjac a moze i sa sluszne? Bo lepiej nagiac czasem pewne zasady dla ogolnego dobra a to co prezentujecie dla mnie jest sprzeczne np. z tym co sie pisze o pisaniu w JAVIE a szkoda ... Podobnie ma sie sprawa zmiennych. Super wyjscie jest z tymi przedrostkami ... ale sami wiecie, ze dlugosc zmiennych wplywa na czas realizacji skryptu. Wiec z jednej strony optymalizacja a z drugiej czytelnosc kodu ... -------------------- Działam w OpenSolution.org, autor Quick.Cms i Quick.Cart już od ponad 10 lat
|
|
|
2.06.2004, 14:20:08
Post
#40
|
|
Grupa: Przyjaciele php.pl Postów: 701 Pomógł: 0 Dołączył: 26.06.2002 Skąd: Londyn Ostrzeżenie: (0%) |
@sztos to jest tylko i wylacznie Twoje subiektywne odczucie, masz po prostu zle przyzwyczajenia z informatyki - tak to jest jak niedouczeni ucza.
Cytat Panowie, co ma spacja do czytelnosci kodu ? [..]
ma, i to wiele. Sh4dow - po co ta rozmowa, no masz inne przyzwyczajenie, osobiscie nie wyobrazam sobie pisania skryptow innym sposobem niz "standardami thot'a". Nawet 4 linijkowy kod, ktory zaraz wykasuje - pisze wg standardow. -------------------- |
|
|
Wersja Lo-Fi | Aktualny czas: 26.09.2024 - 14:00 |