PHP: полный мануал с примерами, функциями и ООП

FAQ как маршрут: сначала среда и симптом, затем решение

FAQ полезен не как случайный список, а как маршрут от симптома к проверяемому слою. Один и тот же «белый экран» может быть ошибкой приложения, настройкой display_errors, журналом FPM или ответом reverse proxy. Сначала фиксируют среду и минимальное воспроизведение, затем выбирают категорию ниже; секреты перед публикацией удаляют.

<?php
declare(strict_types=1);

function supportSnapshot(array $runtime): array
{
    $allowed = ['php_version', 'sapi', 'loaded_ini', 'extension', 'error'];
    $report = array_intersect_key($runtime, array_flip($allowed));
    $report['error'] = preg_replace('~password=[^&\s]+~i', 'password=[redacted]', $report['error'] ?? '');
    return $report;
}

$report = supportSnapshot([
    'php_version' => '8.5.11',
    'sapi' => 'fpm-fcgi',
    'loaded_ini' => '/etc/php/8.5/fpm/php.ini',
    'extension' => 'pdo_mysql',
    'error' => 'SQLSTATE[HY000] dsn=mysql:host=db password=secret',
    'session_cookie' => 'do-not-publish',
]);
foreach ($report as $key => $value) { echo "$key: $value\n"; }

php_version: 8.5.11
sapi: fpm-fcgi
loaded_ini: /etc/php/8.5/fpm/php.ini
extension: pdo_mysql
error: SQLSTATE[HY000] dsn=mysql:host=db password=[redacted]

Общее: что такое PHP, версии и хороший bug report

Эта категория отвечает, что именно запускается и как сопоставить совет с веткой PHP. Для нового проекта выбирают поддерживаемую ветку и проверяют migration notes; номер 8.x не означает совместимость любого расширения и framework.

Mailing lists и сообщества: выбрать правильный канал

Официальный FAQ исторически говорит о mailing lists. Сегодня вопрос может жить в списке рассылки, issue tracker, discussion, Stack Overflow или чате проекта. Выбирайте канал по его правилам: support-вопрос не превращают в bug, а security report не публикуют открыто.

Получение PHP: официальный артефакт, ABI и TS/NTS

PHP получают из официального релиза или поддерживаемого package repository операционной системы. Источник определяет cadence, paths, patches и набор extensions. Не скачивайте случайный DLL/ZIP только потому, что имя совпало.

Пошаговая проверка есть в установке и конфигурации. После загрузки проверяют подпись/hash из независимого официального канала, а не только имя архива.

Базы данных: driver, сервер и модель конкурентности

Слова «PHP поддерживает базу» обычно означают подходящий driver/extension и доступный сервер. Соединение, credentials, TLS, charset и права остаются отдельными условиями. Основной маршрут — PDO от соединения до выборки.

Установка: от белого экрана и 500 до ini, IIS и request methods

Официальная категория хранит много исторических Apache/CGI/FrontPage вопросов. Они сохранены как baseline, но ответы разведены на современный маршрут и legacy-контекст. Начните с канонической установки, затем проверьте web-server error log и SAPI.

Сборка из исходников: toolchain, ABI и исторические ловушки

Сборка PHP из исходников нужна для platform maintainer, необычной extension matrix или tracing build. Обычному приложению воспроизводимый подписанный пакет безопаснее. Старые вопросы ниже сохранены, но команды PHP 4/Apache 1 не переносятся на современный PHP.

Использование PHP: параметры, return, headers, newlines и ini bytes

Категория «Using PHP» соединяет синтаксис и окружение. Сначала минимальный результат, потом edge cases. Большие решения находятся в главах функций, форм, HTTP и переменных.

<?php
declare(strict_types=1);

function priceWithTax(int $price, int $taxPercent): int
{
    return $price + intdiv($price * $taxPercent, 100);
}

$total = priceWithTax(1000, 20);
echo 'Итого: ', $total, "\n";

Итого: 1200

<?php
declare(strict_types=1);

function iniBytes(string $value): int
{
    $value = trim($value);
    if (!preg_match('/^(\d+)([KMG])?$/i', $value, $match)) {
        throw new InvalidArgumentException('Ожидается число и K/M/G');
    }
    $power = match (strtoupper($match[2] ?? '')) {
        'K' => 1, 'M' => 2, 'G' => 3, default => 0,
    };
    return (int) $match[1] * (1024 ** $power);
}
foreach (['128', '2K', '3M', '1G'] as $value) {
    echo "$value = ", iniBytes($value), " bytes\n";
}

128 = 128 bytes
2K = 2048 bytes
3M = 3145728 bytes
1G = 1073741824 bytes

Пароли: медленный hash, встроенная соль и проверка

Пароль не шифруют для обратного чтения и не хешируют быстрым md5/sha1. Используют password_hash, сохраняют всю выданную строку и проверяют password_verify. Полная модель регистрации, login, rate limits и rehash находится в справочнике паролей и безопасности.

<?php
declare(strict_types=1);

$hash = password_hash('correct horse battery staple', PASSWORD_BCRYPT, ['cost' => 4]);
if ($hash === false) { throw new RuntimeException('Hash не создан'); }
echo 'Алгоритм: ', password_get_info($hash)['algoName'], "\n";
echo 'Верный пароль: ', password_verify('correct horse battery staple', $hash) ? 'да' : 'нет', "\n";
echo 'Чужой пароль: ', password_verify('wrong', $hash) ? 'да' : 'нет', "\n";

Алгоритм: bcrypt
Верный пароль: да
Чужой пароль: нет

PHP и HTML: кодирование, массивы form и граница JavaScript

HTML задаёт имена controls, браузер сериализует successful controls, PHP строит $_GET/$_POST. Скобки в name создают массив: customer[phones][]. Это удобная структура, но всё пришедшее остаётся недоверенным input; количество, nesting, тип и значения проверяют по schema. Полный путь формы есть в главе форм.

<?php
declare(strict_types=1);

$query = 'customer[name]=Анна&customer[phones][]=111&customer[phones][]=222&tags[]=php&tags[]=web';
parse_str($query, $input);

echo 'Имя: ', $input['customer']['name'], "\n";
foreach ($input['customer']['phones'] as $index => $phone) {
    echo 'Телефон ', $index + 1, ': ', $phone, "\n";
}
echo 'Теги: ', implode(', ', $input['tags']), "\n";

Имя: Анна
Телефон 1: 111
Телефон 2: 222
Теги: php, web

PHP и COM: Windows-only boundary, variants, events и DCOM

COM extension относится к Windows и Automation-compatible components. Для нового cross-platform сервиса HTTP/gRPC/queue обычно легче изолирует технологию. Если legacy COM обязателен, вся подробная типизация, variants, events и remote boundary разобрана в COM reference.

Прочее: bzip2-архив руководства на Windows

Файл руководства с расширением .bz2 — bzip2-compressed archive, а не программа. На Windows его распаковывает 7-Zip или другой поддерживающий bzip2 архиватор; после распаковки открывают HTML/index. Не переименовывайте extension и не запускайте содержимое как executable.