Výchozí hodnoty nepovinných parametrů v PHP dokumentaci

Školení, která pořádám

Když jsem zjistil, že formát Docbook, ve kterém je napsaná PHP dokumentace, podporuje uvádění výchozích hodnot nepovinných parametrů v deklaracích funkcí (a že tuto značku podporuje i PhD), rozhodl jsem se tyto výchozí parametry do dokumentace doplnit pokud možno u všech funkcí, kde to dává smysl (implementace některých funkcí se rozhodují podle počtu parametrů, takže výchozí hodnota nemá význam).

Bylo to samozřejmě obrovské množství práce, nakonec se mi ji ale podařilo dokončit. Kromě poučného pohledu do PHP zdrojáků jsem se místy i pobavil. Nejvíc asi u metody Phar::convertToExecutable, kde je výchozí hodnota parametrů format a method nastavena na magické číslo 9021976 (parametry přitom můžou nabývat hodnot od 0 do 3). Ve zdrojovém kódu je to dokonce i vysvětleno jako:

Číslo, které není 0, 1 ani 2 (což jsou taky Gregovy narozeniny)

Takže Gregu, 15.4. vše nejlepší…

Jakub Vrána, Ze zákulisí, 26.1.2009, diskuse: 5 (nové: 0)

Diskuse

Joelp:

Při přechodu na PhD se "ztratila" CS verze. Fyzicky tam je, ale asi jen jako Docbook.
Bude i v PhD časem čeština?

26.1.2009 07:16:03

Jakub Vrána :

Česká verze se přestala exportovat proto, že je velmi zastaralá a neudržovaná. Obsahuje tedy matoucí informace. Nicméně je stále k dispozici na http://www.php.net/manual/cs/, jen už na ni nevede odkaz.

26.1.2009 07:23:34

Joelp:

V této staré verzi je přehledný obsah a jeho struktura mi sedí víc. Lépe se mi v něm hledá, když potřebuji fci, kde vím +- co by měla dělat, ale neznám její jméno. V té nové (aktuálně odkazované na php.net) se nedokážu orientovat.

26.1.2009 14:21:40

Jakub Vrána :

Mě také stará struktura vyhovovala lépe a byl jsem její zastánce. Abecední seznam extenzí se přesunul z obsahu na http://www.php.net/manual/en/extensions.alphabetical.php.

26.1.2009 15:23:00