함수 선언(prototype)을 읽는 법

각 함수는 빠른 레퍼런스를 위해 문서화되어있다. 매뉴얼을 읽고 이해하는 법을 알면 PHP 학습이 더욱 쉬워질 것이다. 예제나 복사/붙여넣기에 의지하기 보다는, 함수 선언(prototypes)을 읽는 법을 알아야 합니다. 시작해 봅시다:

Note: 필요 조건: 타입에 대한 기본적인 이해

PHP가 느슨한 타입 언어임에도 불구하고, 타입에 대한 기본적인 이해는 중요합니다. 타입은 중요한 의미를 가지고 있기 때문입니다.

함수 선언은 어떤 타입의 값이 반환되는지 알려줍니다. 첫번째 예제로 strlen()에 대한 선언을 사용합시다:

strlen

(PHP 4, PHP 5)
strlen -- 문자열의 길이를 구합니다.

설명
int strlen ( string $string )

문자열의 길이를 반환합니다.

위 함수 선언을 일반적인 방법으로 다시 작성할 수 있습니다:

      반환형    함수이름    ( 인수형   인수이름 )

in_array()처럼, 많은 함수는 여러 인수를 가집니다. 프로토타입은 다음과 같습니다:

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

이것이 무엇을 의미할까요? in_array()는 불값을 반환합니다. 성공시(haystack에서 needle을 찾았을 때)에는 TRUE를, 실패시(haystack에서 needle을 찾지 못했을 때)에는 FALSE입니다. 첫번째 인수는 needle이라는 이름을 가지고, 여러 타입이 될 수 있기 때문에, "mixed"라고 불립니다. (찾을 목표인) mixed needle은 스칼라 값(문자열, 정수, 실수)이나 배열이 될 수 있습니다. (찾아볼 배열) haystack은 두번째 인수입니다. 세번째 선택적인 인수 이름은 strict입니다. 모든 선택적인 인수는 [ 브라켓 ] 사이에 들어갑니다. 매뉴얼에 strict 인수의 기본값은 불 FALSE로 나와 있습니다. 인수가 어떻게 동작하는지에 대한 자세한 사항은 각 함수의 매뉴얼 페이지를 참고하십시오.

조금 복잡한 PHP 버전 정보를 가지는 함수도 있습니다. 예를 들어 html_entity_decode()를 봅시다:

(PHP 4 >= 4.3.0, PHP 5)

이 함수가 PHP 4.3.0 이후에 릴리즈된 버전에서만 사용할 수 있음을 나타냅니다.