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

<?php
declare(strict_types=1);

function basicAuthDecision(array $server, array $accounts): array
{
    $user = $server['PHP_AUTH_USER'] ?? null;
    $password = $server['PHP_AUTH_PW'] ?? null;
    if (!is_string($user) || !is_string($password)) {
        return ['status' => 401, 'user' => null];
    }
    $storedHash = $accounts[$user] ?? null;
    if (!is_string($storedHash) || !password_verify($password, $storedHash)) {
        return ['status' => 401, 'user' => null];
    }
    return ['status' => 200, 'user' => $user];
}

$accounts = ['anna' => password_hash('river-42', PASSWORD_DEFAULT)];
foreach ([
    [],
    ['PHP_AUTH_USER' => 'anna', 'PHP_AUTH_PW' => 'wrong'],
    ['PHP_AUTH_USER' => 'anna', 'PHP_AUTH_PW' => 'river-42'],
] as $server) {
    $answer = basicAuthDecision($server, $accounts);
    echo $answer['status'], ' ', $answer['user'] ?? '-', "\n";
}

401 -
401 -
200 anna

Первый вход не содержит заголовка, второй содержит неверный пароль, третий проходит password_verify. Hash создаётся только ради изолированного опыта; production читает сохранённый hash из базы.

<?php
declare(strict_types=1);

$accounts = ['anna' => '$2y$12$replace_with_a_hash_from_password_hash'];
$user = $_SERVER['PHP_AUTH_USER'] ?? null;
$password = $_SERVER['PHP_AUTH_PW'] ?? null;
$hash = is_string($user) ? ($accounts[$user] ?? null) : null;
if (!is_string($password) || !is_string($hash) || !password_verify($password, $hash)) {
    header('WWW-Authenticate: Basic realm="Warehouse"');
    http_response_code(401);
    echo 'Требуется вход';
    exit;
}
header('Content-Type: text/plain; charset=UTF-8');
echo 'Остатки доступны для ', $user;

Первый запрос: HTTP 401 и WWW-Authenticate: Basic realm="Warehouse". После верного ввода: HTTP 200 и «Остатки доступны для anna».

Это lint-пример: итог зависит от HTTPS, SAPI, веб-сервера и браузера. Realm пишется в двойных кавычках, перед кодом 401 в status line нужен ровно один пробел. В Apache активная внешняя AuthType может менять источник данных; за CGI/FastCGI прокси должен передать Authorization по доверенной конфигурации.

<?php
declare(strict_types=1);

function preferenceCookie(string $theme, int $now): array
{
    if (!in_array($theme, ['light', 'dark'], true)) {
        throw new InvalidArgumentException('Неизвестная тема');
    }
    return [
        'name' => 'theme',
        'value' => $theme,
        'options' => [
            'expires' => $now + 86400 * 30,
            'path' => '/',
            'secure' => true,
            'httponly' => true,
            'samesite' => 'Lax',
        ],
    ];
}

$cookie = preferenceCookie('dark', 1_800_000_000);
echo $cookie['name'], '=', $cookie['value'], "\n";
echo $cookie['options']['expires'], "\n";
echo $cookie['options']['samesite'], ' secure=', $cookie['options']['secure'] ? 'yes' : 'no', "\n";

theme=dark
1802592000
Lax secure=yes

Функция только строит проверенную запись и потому выполняется в CLI. В HTTP-контроллере вызов будет setcookie($cookie['name'], $cookie['value'], $cookie['options']).

<?php
declare(strict_types=1);

function uploadMessage(int $error): string
{
    return match ($error) {
        UPLOAD_ERR_OK => 'Файл принят во временное хранилище',
        UPLOAD_ERR_INI_SIZE, UPLOAD_ERR_FORM_SIZE => 'Файл больше разрешённого',
        UPLOAD_ERR_PARTIAL => 'Передача оборвалась',
        UPLOAD_ERR_NO_FILE => 'Файл не выбран',
        UPLOAD_ERR_NO_TMP_DIR => 'На сервере нет временного каталога',
        UPLOAD_ERR_CANT_WRITE => 'Сервер не смог записать временный файл',
        UPLOAD_ERR_EXTENSION => 'Расширение PHP остановило загрузку',
        default => 'Неизвестный код загрузки',
    };
}

foreach ([UPLOAD_ERR_OK, UPLOAD_ERR_INI_SIZE, UPLOAD_ERR_PARTIAL, UPLOAD_ERR_NO_FILE, 99] as $error) {
    echo $error, ': ', uploadMessage($error), "\n";
}

0: Файл принят во временное хранилище
1: Файл больше разрешённого
3: Передача оборвалась
4: Файл не выбран
99: Неизвестный код загрузки

match перечисляет все официальные коды. Пока код не равен UPLOAD_ERR_OK, tmp_name, type и size нельзя считать полезными данными файла.

<?php
declare(strict_types=1);

function normalizeUploads(array $files): array
{
    $result = [];
    foreach ($files['name'] ?? [] as $index => $name) {
        $result[] = [
            'name' => (string) $name,
            'tmp_name' => (string) ($files['tmp_name'][$index] ?? ''),
            'error' => (int) ($files['error'][$index] ?? UPLOAD_ERR_NO_FILE),
            'size' => (int) ($files['size'][$index] ?? 0),
        ];
    }
    return $result;
}

$files = [
    'name' => ['front.png', 'back.png'],
    'tmp_name' => ['/tmp/a', '/tmp/b'],
    'error' => [UPLOAD_ERR_OK, UPLOAD_ERR_PARTIAL],
    'size' => [1250, 400],
];
foreach (normalizeUploads($files) as $file) {
    echo $file['name'], ': error=', $file['error'], ', bytes=', $file['size'], "\n";
}

front.png: error=0, bytes=1250
back.png: error=3, bytes=400

Второй элемент не готов к сохранению: error=3. В реальном запросе tmp_name проверяется is_uploaded_file; здесь пути намеренно фиктивны и не используются.

<?php
declare(strict_types=1);

function acceptPut(string $method, string $contentType, string $body, int $limit = 1024): string
{
    if ($method !== 'PUT') { return '405 Method Not Allowed'; }
    if ($contentType !== 'application/json') { return '415 Unsupported Media Type'; }
    if (strlen($body) > $limit) { return '413 Content Too Large'; }
    try {
        $data = json_decode($body, true, 8, JSON_THROW_ON_ERROR);
    } catch (JsonException) {
        return '400 Invalid JSON';
    }
    if (!is_array($data) || !is_int($data['stock'] ?? null) || $data['stock'] < 0) {
        return '422 Invalid stock';
    }
    return '200 stock=' . $data['stock'];
}

foreach ([
    ['POST', 'application/json', '{"stock":8}'],
    ['PUT', 'text/plain', '{"stock":8}'],
    ['PUT', 'application/json', '{bad'],
    ['PUT', 'application/json', '{"stock":8}'],
] as [$method, $type, $body]) {
    echo acceptPut($method, $type, $body), "\n";
}

405 Method Not Allowed
415 Unsupported Media Type
400 Invalid JSON
200 stock=8

Функция получает уже прочитанное тело, поэтому проверяется детерминированно. HTTP endpoint передаст file_get_contents('php://input') и ответит соответствующим статусом.

<?php
declare(strict_types=1);

$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'timeout' => 3.0,
        'ignore_errors' => true,
        'header' => [
            'Accept: application/json',
            'User-Agent: WarehouseImporter/1.0',
        ],
    ],
]);
$json = file_get_contents('https://inventory.example.test/products/42', false, $context);
if ($json === false) {
    throw new RuntimeException('Транспорт не вернул тело');
}
$statusLine = $http_response_header[0] ?? '';
if (!preg_match('~^HTTP/\S+ 200(?: |$)~', $statusLine)) {
    throw new RuntimeException('Неуспешный HTTP-статус: ' . $statusLine);
}
$product = json_decode($json, true, 16, JSON_THROW_ON_ERROR);
if (!is_string($product['name'] ?? null) || !is_int($product['stock'] ?? null)) {
    throw new RuntimeException('Контракт ответа изменился');
}

При HTTP 200 и контракте {"name":"Молоток","stock":8} переменная $product содержит проверенные name и stock; при transport/status/JSON/schema отказе выбрасывается отдельная RuntimeException.

Синтаксис проверяется локально. Домен .test намеренно не существует: пример нельзя выдавать за выполненный сетевой запрос. Для production API cURL удобнее при TLS, redirects, detailed errors и нескольких запросах.

<?php
declare(strict_types=1);

function connectionLabel(int $status): string
{
    $parts = [];
    if ($status === CONNECTION_NORMAL) { return 'normal'; }
    if (($status & CONNECTION_ABORTED) !== 0) { $parts[] = 'aborted'; }
    if (($status & CONNECTION_TIMEOUT) !== 0) { $parts[] = 'timeout'; }
    return implode('+', $parts) ?: 'unknown';
}

foreach ([CONNECTION_NORMAL, CONNECTION_ABORTED, CONNECTION_TIMEOUT,
          CONNECTION_ABORTED | CONNECTION_TIMEOUT] as $status) {
    echo $status, ': ', connectionLabel($status), "\n";
}

0: normal
1: aborted
2: timeout
3: aborted+timeout

Пример объясняет константы в CLI. Он не утверждает, что браузерный разрыв можно надёжно сымитировать без конкретного веб-сервера и прокси.

<?php
declare(strict_types=1);

function connectionBudget(int $workers, int $connectionsPerWorker, int $reserve): array
{
    if ($workers < 1 || $connectionsPerWorker < 1 || $reserve < 0) {
        throw new InvalidArgumentException('Параметры бюджета должны быть положительными');
    }
    $application = $workers * $connectionsPerWorker;
    return ['application' => $application, 'minimum_server_limit' => $application + $reserve];
}

$budget = connectionBudget(8, 3, 6);
echo 'Приложение: ', $budget['application'], "\n";
echo 'С резервом: ', $budget['minimum_server_limit'], "\n";

Приложение: 24
С резервом: 30

Резерв оставлен для миграций, администратора и фоновых задач. Реальный максимум сверяют с размером pool, количеством приложений и лимитом СУБД.

<?php
declare(strict_types=1);

$pdo = new PDO(
    'mysql:host=db.internal;dbname=shop;charset=utf8mb4',
    getenv('DB_USER') ?: '',
    getenv('DB_PASSWORD') ?: '',
    [
        PDO::ATTR_PERSISTENT => true,
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    ]
);
try {
    $pdo->exec("SET SESSION time_zone = '+00:00'");
    $pdo->beginTransaction();
    // ... один законченный unit of work ...
    $pdo->commit();
} catch (Throwable $error) {
    if ($pdo->inTransaction()) { $pdo->rollBack(); }
    throw $error;
}

При доступной MySQL и верных credentials соединение создаётся/переиспользуется, timezone задаётся заново, транзакция завершается commit либо rollback.

Это lint-пример: локальная проверка не поднимает MySQL и не доказывает повторное использование между FPM-запросами. У PDO ATTR_PERSISTENT передают в constructor options; поздний setAttribute не включает persistent connection задним числом.