Относно ръководството
PHP Manual

Как се четат дефинициите на функциите (прототипи)

Всяка функция е документирана за бърза справка. Познанието за това как се чете ръководството и неговото разбиране ще направи използването на PHP много по-лесно. Вместо да се осланяте на примери или cut/paste, вие по-скоро ще искате да знаете как да четете дефинициите на функциите (прототипи). Нека започнем:

Забележка: Необходимо условие: Основно разбиране на типовете
Въпреки че PHP не е строго типов език, е важно да имате основна представа от типове, тъй като те имат важно значение.

Дефинициите на функциите ни казват какъв тип е връщаната стойност. Да използваме дефиницията на strlen() за наш първи пример:


strlen

(PHP 3, PHP 4 >= 4.0.0)
strlen -- Вземане дължината на низ

Описание
int strlen ( string str )

Връща дължината на низ.

Обяснение на дефиницията
Част Описание
strlen Името на функцията.
(PHP 3, PHP 4 >= 4.0.0) strlen() съществува и в PHP 3 и в PHP 4
int Типът стойност, връщана от тази функция, който е integer (Дължината на низ се измерва с числа).
( string str ) Първият (и в случая - единствен) параметър/аргумент за функцията strlen() се нарича str и е string.

Можем да пренапишем по-горната дефиниция на функция в общ вид:


връщан тип име на функция ( тип на параметъра име на параметъра )

Много функции, като in_array(), приемат множество параметри. Нейният прототип е както следва:


bool in_array ( mixed needle, array haystack [, bool strict])

Какво означава това? in_array() връща boolean стойност, TRUE при успех (ако needle е бил намерен в haystack ) или FALSE при неуспех (ако needle не е бил намерен в haystack ). Първият параметър се нарича needle и може да бъде много различни типове, така че го наричаме "mixed" (смесен). Този смесен needle (това, което търсим) може да бъде или скаларна стойност (string, integer или float) или array. haystack (масивът, в който търсим) е втория параметър. Третият незадължителен параметър се нарича strict . Всички незадължителни параметри са в [ квадратни скоби ]. Ръководството упоменава, че параметърът strict има стойност по подразбиране boolean FALSE. За повече информация относно това, как работят самите функции, погледнете съответните страници в ръководството.


Относно ръководството
PHP Manual