1. 어디서 보나: 문서 구조 빠르게 파악

Language Reference: 문법, 타입, 오류 처리, OOP, 예외, 속성(Attributes) 등 언어 자체.
Function Reference: 문자열, 배열, 날짜, 파일/스트림, 네트워크, 정규식, cURL, PDO 등 모듈/확장별 함수.
Security/Features: 세션, 쿠키, 스트림 래퍼, 필터 등 구성 요소.
INI 설정: php.ini 지시자별 의미·기본값·변경 가능한 범위.
FAQ/Appendices: 마이그레이션 가이드(버전별 변경점), 지원 프로토콜 목록, RFC 등.

팁: 함수 문서는 php.net/함수이름 으로 바로 접속할 수 있습니다. 예) php.net/strpos

좌측 상단 검색에서 함수·지시자·확장명을 바로 검색하세요. 페이지 상단에서 언어(ko/en), 버전 선택도 가능합니다.

2. 함수 문서 읽는 법: 체크리스트 8가지

예시로 strpos를 떠올리며 보겠습니다.

시그니처(Prototype)
- 예: strpos(string $haystack, string $needle, int $offset = 0): int|false
- 매개변수 타입, 기본값, 반환 타입(단일/유니온)을 먼저 본다.
Parameters
- 각 인자의 의미와 엣지 케이스를 읽는다.
- 예: $offset이 음수일 때 의미, $needle이 빈 문자열일 때 동작 등.
Return Values
- int|false처럼 유니온 타입이면 분기 처리를 엄격비교로:

$pos = strpos($s, 'a');
if ($pos === false) { /* 못 찾음 */ } else { /* 0도 유효한 위치 */ }

- “에러 시 false”인지, “예외를 던지는지” 구분한다. PHP 8부터 일부 함수는 TypeError/ValueError 예외를 던진다.
Errors/Exceptions
- 어떤 예외 클래스가 발생하는지 확인. try/catch 범위를 결정한다.
Changelog
- 버전에 따라 동작·타입이 달라졌는지 확인.
- 팀/서버의 PHP 버전과 맞지 않으면 문서 오른쪽 상단에서 대상 버전으로 바꿔 읽는다.
Notes/Warnings
- 인코딩, 로케일, 멀티바이트 이슈, 보안 주의사항이 자주 적혀 있다.
Examples
- 문서 예제를 복사 → 최소 재현으로 실행해 동작을 확인한다.
See Also
- 대체/보완 함수 링크로 더 적절한 API가 있는지 비교한다.
- 예: str_contains()(PHP 8+)가 의도에 더 맞을 수 있다.

3. 언어 기능(문법) 문서 읽는 법

타입 시스템: 스칼라/복합/특수(null), 유니온 타입(A|B), 널 허용(?T), mixed, callable 의미를 파악.
오류 처리: 경고/공지 vs 예외. PHP 8에서 많은 내장 함수가 예외를 던짐.
OOP: 가시성, 상속, 트레이트, 인터페이스, 추상, 속성(Attributes), enum(8.1+) 등 버전 의존 기능 확인.
연산자/제어구조: Nullsafe(?->), match(8.0+) 등 최신 문법 여부 체크.

문법 페이지는 개념 → 구문 → 예제 → 주의사항 순으로 읽으면 안정적입니다.

4. 확장(Extension) 문서 읽는 법

예: PDO, cURL, mbstring, intl

설치/활성화: 패키지명, php.ini/extension 지시자 확인.
INI 옵션: 확장별로 따로 있는 경우 많음. 기본값, 변경 가능 범위(PHP_INI_ALL / PERDIR / SYSTEM)를 본다.
리소스/객체 수명: 연결 핸들/객체가 언제 해제되는지, 예외 방식을 파악.
에러 처리 규칙: PDO는 PDO::ERRMODE_EXCEPTION을 권장 등.

5. php.ini

지시자 문서 읽는 법

각 지시자 페이지에 다음이 나옵니다.

설명/기본값/변경 가능 범위
- PHP_INI_ALL → ini_set()로 런타임 변경 가능
- PHP_INI_PERDIR → php.ini, httpd.conf, .htaccess에서 가능
- PHP_INI_SYSTEM → 시스템 레벨에서만
성능/보안 주의사항: 예) display_errors=Off(운영), log_errors=On, memory_limit, max_execution_time, opcache.* 등

6. 스트림/컨텍스트 문서 포인트

파일/HTTP/소켓은 스트림 기반입니다.

Supported Protocols and Wrappers: file://, http://, php://, zip:// 등 목록과 기능.
Context options and parameters: stream_context_create()로 설정하는 옵션 키가 정리되어 있습니다.

예: HTTP 타임아웃, 헤더, 프록시, SSL 검증 등.

7. 마이그레이션 가이드 활용

버전 올릴 때는 Migration 섹션을 필독:

제거/비권장 함수 목록
오류가 예외로 승격된 항목
반환 타입 변경, 경고→예외 전환, 기본 인코딩/로캘 변화 등
대체 API 제시

이 가이드와 Changelog를 함께 보면 업그레이드 이슈를 빠르게 잡습니다.

8. 사용자 코멘트(User Contributed Notes) 읽을 때 주의

훌륭한 팁도 있지만 오래된 내용이 섞여 있습니다.
항상 본문 기준/버전을 먼저 확인하고, 코멘트는 보조 참고로만 사용하세요.
투표가 높고 최신인 코멘트를 우선 보되, 재현 테스트로 검증합니다.

9. 실무에서 자주 부딪히는 해석 포인트

false vs “유효한 0”: strpos()처럼 반환이 0|false인 함수는 **===**로 구분.
경고/공지 vs 예외: PHP 8+에서 많은 함수가 예외를 던집니다. 문서의 Errors/Exceptions를 반드시 확인.
멀티바이트: 문자열 길이/부분 문자열은 mb_* 함수군과 내 문자열 인코딩을 문서에서 확인.
시간대: 날짜 함수는 기본 타임존 설정에 영향. date.timezone 지시자 문서를 확인.
보안: filter_*, password_*, hash_*, openssl_* 문서는 권장 알고리즘/설정을 최신으로 확인.

10. 문서와 함께 쓰는 CLI 확인 명령

문서로 개념을 잡고, CLI로 현재 환경을 검증합니다.

php -v                 # PHP/Xdebug 버전
php --ini              # 사용 중인 ini 파일들
php -m                 # 로드된 확장 목록
php --ri xdebug        # 특정 확장 설정 보기(ri = ext info)
php -i | less          # phpinfo() 전체

PHP 8+는 리플렉션 기반 단축 명령도 유용합니다.

php --rf strpos        # 함수 시그니처/설명 요약
php --re pdo           # 확장 요약

11. 예시: 문서로부터 안전한 코드로 옮기는 흐름

문서 발췌(가정): preg_match(string $pattern, string $subject): int|false

반환: 일치 1, 불일치 0, 오류 false

코드:

$r = preg_match('/\d+/', $s);
if ($r === false) {
    // 오류 처리 (패턴 에러 등)
} elseif ($r === 1) {
    // 매치됨
} else {
    // 매치 안 됨 (0)
}

문서의 반환 규약을 엄격비교로 정확히 반영하는 것이 핵심입니다.

12. 빠른 체크리스트(북마크용)

페이지 상단 버전을 내 런타임과 일치시켰는가
시그니처/반환 타입을 보고 === 필요 여부를 판단했는가
Errors/Exceptions에 명시된 예외를 처리했는가
Changelog에서 내 버전에 영향 있는 변경이 있는가
관련 INI 지시자/기본값/변경 가능 범위를 확인했는가
예제를 최소 재현으로 직접 실행해 봤는가

PHP 공식 매뉴얼(php.net/manual)