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

<?php
var_dump(ctype_alnum("SKU42"));
var_dump(ctype_alnum("SKU_42"));
var_dump(ctype_alnum(""));

bool(true)
bool(false)
bool(false)

alnum объединяет alphabetic и numeric. Наличие букв не обязательно: "42" тоже подходит. Проверяется состав, а не формат артикула.

<?php
$codes = ["BR41", "BR-41", ["BR41"], "123456789"];
foreach ($codes as $code) {
    if (!is_string($code) || strlen($code) > 8 || !ctype_alnum($code)) {
        echo "Отклонён\n";
        continue;
    }
    echo "Код: ", $code, "\n";
}

Код: BR41
Отклонён
Отклонён
Отклонён

Массив моделирует строки импорта. foreach берёт следующий элемент. || прекращает вычисление после истинного условия, поэтому массив не попадёт в strlen/ctype. continue пропускает неподходящий элемент. Длина проверена до посимвольного прохода.

<?php
var_dump(ctype_alpha("Ready"));
var_dump(ctype_alpha("Ready now"));
var_dump(ctype_alpha("Ready2"));

bool(true)
bool(false)
bool(false)

Ready содержит только буквы. Второй ответ отрицательный из-за пробела, третий — из-за цифры. Проверка не меняет регистр.

<?php
foreach (["ping", "delete", "ping2"] as $command) {
    if (strlen($command) > 12 || !ctype_alpha($command)) {
        echo "Неверная форма команды\n";
    } elseif (!in_array($command, ["ping", "status"], true)) {
        echo "Команда не разрешена\n";
    } else {
        echo "Разрешена: ", $command, "\n";
    }
}

Разрешена: ping
Команда не разрешена
Неверная форма команды

Сначала проверен состав короткой строки, затем белый список. Третий аргумент true у in_array включает строгое сравнение. Здесь ничего не отправляется и не выполняется: это модель выбора разрешённой команды.

<?php
var_dump(ctype_cntrl("\r\n\t"));
var_dump(ctype_cntrl("Order\n41"));
var_dump(ctype_cntrl(" "));

bool(true)
bool(false)
bool(false)

В двойных кавычках \r, \n, \t обозначают возврат каретки, перевод строки и табуляцию. Обычный пробел не управляющий символ. false во втором случае не означает отсутствия управляющего байта: не все байты управляющие.

<?php
function firstControlByte(string $text): ?int
{
    $length = strlen($text);
    for ($position = 0; $position < $length; $position++) {
        if (ctype_cntrl($text[$position])) {
            return $position;
        }
    }
    return null;
}
var_dump(firstControlByte("ORD\n41"));
var_dump(firstControlByte("ORD41"));

int(3)
NULL

Функция возвращает позицию первого управляющего байта либо null. Индексы строки начинаются с 0: O=0, R=1, D=2, перевод=3. for проверяет по одному байту, поэтому здесь вопрос «есть хотя бы один». Результат 0 был бы допустимой позицией; проверяйте !== null, а не if($position).

<?php
$identifiers = ["ORD41", "ORD\n42"];
foreach ($identifiers as $identifier) {
    $badPosition = null;
    for ($position = 0; $position < strlen($identifier); $position++) {
        if (ctype_cntrl($identifier[$position])) {
            $badPosition = $position;
            break;
        }
    }
    if ($badPosition !== null) {
        echo "Строка импорта отклонена: управляющий байт на позиции ", $badPosition, "\n";
        continue;
    }
    echo "Можно искать заказ: ", $identifier, "\n";
}

Можно искать заказ: ORD41
Строка импорта отклонена: управляющий байт на позиции 3

Партнёр выгрузил ID заказов; в один попал невидимый перевод строки. Если незаметно убрать его, значение изменится и может совпасть с чужим ID. Поэтому импорт отклоняет строку и сообщает позицию. break завершает внутренний поиск после первого сбоя, continue переходит к следующему ID. !== null сохраняет правильную обработку ошибки на позиции 0. Вывод здесь консольный: в HTML сообщения экранируют. Остальные правила ID и наличие заказа проверяются следующим шагом.

<?php
var_dump(ctype_digit("007"));
var_dump(ctype_digit("-7"));
var_dump(ctype_digit("7.0"));
var_dump(ctype_digit("7e2"));
var_dump(ctype_digit("0"));

bool(true)
bool(false)
bool(false)
bool(false)
bool(true)

Знак, точка и буква e не цифры. Ноль и ведущие нули допустимы для проверки символов. Большая строка цифр тоже может пройти, хотя её число не помещается в int.

<?php
function hasFourDigits(mixed $value): bool
{
    return is_string($value) && strlen($value) === 4 && ctype_digit($value);
}
foreach (["0041", "41", "4e01", ["0041"], 41] as $value) {
    if (!hasFourDigits($value)) {
        echo "Введите код из четырёх цифр\n";
        continue;
    }
    $parcels = ["0041" => "Передана курьеру"];
    echo "Посылка ", $value, ": ", $parcels[$value] ?? "не найдена", "\n";
}

Посылка 0041: Передана курьеру
Введите код из четырёх цифр
Введите код из четырёх цифр
Введите код из четырёх цифр
Введите код из четырёх цифр

mixed разрешает функции принять любой PHP-тип и самой вернуть отказ. && означает «все условия верны» и останавливается при первом false. Сначала функция отвечает на маленький вопрос о формате. Вызывающий код использует ответ: при ошибке выводит подсказку, при успехе ищет посылку в учебном массиве. Код 0041 остаётся строкой с нулями. Добавьте в список 9999: формат правильный, но посылка не найдена. Нативный int 41 сознательно не принимаем: по договору поле должно быть текстом. Это не проверка подлинности секретного PIN: срок действия, доступ и ограничение попыток потребовали бы отдельной логики.

<?php
var_dump(ctype_graph("ORD-41"));
var_dump(ctype_graph("ORD 41"));
var_dump(ctype_graph("ORD\t41"));

bool(true)
bool(false)
bool(false)

Дефис разрешён как печатный символ; обычный пробел и табуляция не проходят. graph — не сокращение от графика: речь о видимых печатных символах.

<?php
$parts = explode(" ", "SEND  ORD-41");
foreach ($parts as $part) {
    if (ctype_graph($part)) {
        echo $part, "\n";
    }
}

SEND
ORD-41

explode разделяет по каждому обычному пробелу. Два пробела создают пустую часть: ctype_graph её отклоняет. Такой разбор подходит только простому договору без кавычек и вложенных значений; полноценному языку нужен его парсер.

<?php
var_dump(ctype_lower("draft"));
var_dump(ctype_lower("draft2"));
var_dump(ctype_lower("Draft"));

bool(true)
bool(false)
bool(false)

Цифра 2 не является строчной буквой, хотя не имеет верхнего регистра. Поэтому ctype_lower и «нет заглавных букв» — разные условия.

<?php
function isSectionWord(string $name): bool
{
    return strlen($name) <= 20 && ctype_lower($name);
}
foreach (["catalog", "my-catalog", "Catalog", ""] as $name) {
    if (!isSectionWord($name)) {
        echo "Имя раздела не подходит\n";
        continue;
    }
    $pages = ["catalog" => "Каталог товаров", "contacts" => "Контакты"];
    echo $pages[$name] ?? "Раздел не найден", "\n";
}

Каталог товаров
Имя раздела не подходит
Имя раздела не подходит
Имя раздела не подходит

Этот договор разрешает только короткое слово из строчных букв. После проверки вызывающий код выбирает заголовок из известного списка; catalog открывает каталог. Добавьте news: строка допустима, но раздел не найден. PHP-файлы по пользовательскому пути здесь не подключаются. Если проекту нужны дефисы или цифры, меняют правило осознанно; слепое удаление знаков может столкнуть разные имена. Для UTF-8-названий ctype_lower не подходит.

<?php
var_dump(ctype_print("Order 41"));
var_dump(ctype_print("Order\n41"));
var_dump(ctype_print(" "));

bool(true)
bool(false)
bool(true)

print в названии означает группу печатных байтов: сама функция ничего не печатает. Печатает var_dump. Обычный пробел допустим, управляющий перевод строки нет.

<?php
$labels = ["Order 41", "   ", "Order\n41"];
foreach ($labels as $label) {
    $valid = strlen($label) <= 24 && ctype_print($label) && !ctype_space($label);
    echo $valid ? "Можно передать\n" : "Исправьте подпись\n";
}

Можно передать
Исправьте подпись
Исправьте подпись

Условие моделирует устройство, которое принимает до 24 печатных ASCII-байтов в одной строке. Дополнительный !ctype_space отвергает подпись только из пробелов. Реального сетевого вызова нет. Перед поддержкой русского текста нужно изменить контракт устройства и кодировки, а не просто убрать проверку.

<?php
var_dump(ctype_punct("-_"));
var_dump(ctype_punct("!?"));
var_dump(ctype_punct("A!"));
var_dump(ctype_punct("! "));

bool(true)
bool(true)
bool(false)
bool(false)

В C сюда входят печатные знаки, которые не являются буквами, цифрами или пробелами. Подчёркивание — один из них. В A! одна буква, поэтому вся строка не состоит из пунктуации.

<?php
function validReportSeparator(string $separator): bool
{
    return strlen($separator) === 1
        && ctype_punct($separator)
        && in_array($separator, [";", "|", ","], true);
}
foreach ([";", "||", "<", " "] as $separator) {
    if (!validReportSeparator($separator)) {
        echo "Этот разделитель не поддерживается\n";
        continue;
    }
    $output = fopen('php://output', 'w');
    fputcsv($output, ['Артикул', 'Цена'], $separator, '"', '');
    fputcsv($output, ['BR41', '250'], $separator, '"', '');
    fclose($output);
}

Артикул;Цена
BR41;250
Этот разделитель не поддерживается
Этот разделитель не поддерживается
Этот разделитель не поддерживается

Получили настоящий текст отчёта с выбранным разделителем. php://output направляет запись в вывод программы; для файла передают путь к файлу. fputcsv учитывает кавычки и разделители внутри полей, пятый аргумент отключает нестандартное экранирование обратной косой чертой. Длина оставляет один байт, ctype_punct проверяет его класс, белый список сужает возможности. В таком коротком списке ctype-проверка избыточна: в рабочем коде достаточно списка. Она оставлена здесь, чтобы различить класс символа и разрешённые настройки отчёта.

<?php
var_dump(ctype_space(" \t\r\n"));
var_dump(ctype_space("A B"));
var_dump(ctype_space(""));
var_dump(ctype_space("0"));

bool(true)
bool(false)
bool(false)
bool(false)

Кроме обычного пробела группа включает горизонтальную/вертикальную табуляцию, перевод строки, возврат каретки и перевод страницы. Пустая строка не пробельная строка. "0" — содержательный текст, его нельзя отбрасывать как пустой только из-за приведения к bool.

<?php
$items = explode("|", "Поставка|   |0||Монтаж");
foreach ($items as $item) {
    if ($item === "" || ctype_space($item)) {
        continue;
    }
    echo $item, "\n";
}

Поставка
0
Монтаж

Отдельно исключили нулевую длину и строку только из ASCII-пробелов. В остальных элементах ничего не меняем. Кириллица в непустом пункте просто не пробельная; это не попытка классифицировать её буквы. Для скопированных Unicode-пробелов нужен другой явный договор.

<?php
var_dump(ctype_upper("USD"));
var_dump(ctype_upper("US2"));
var_dump(ctype_upper("Usd"));

bool(true)
bool(false)
bool(false)

U, S, D — заглавные буквы. Цифра и строчная d не удовлетворяют требованию. Это проверка, не преобразование регистра.

<?php
foreach (["USD", "ZZZ", "US2"] as $currency) {
    if (strlen($currency) !== 3 || !ctype_upper($currency)) {
        echo "Неверный формат\n";
    } elseif (!in_array($currency, ["RUB", "USD", "EUR"], true)) {
        echo "Валюта не поддерживается магазином\n";
    } else {
        echo "Поддерживается: ", $currency, "\n";
    }
}

Поддерживается: USD
Валюта не поддерживается магазином
Неверный формат

Три заглавные буквы — проверка формы. Поддерживаемые валюты — настройка нашего учебного магазина, а не полный международный каталог и не гарантия работы платёжного провайдера. В коде нет платежей.

<?php
var_dump(ctype_xdigit("1aF0"));
var_dump(ctype_xdigit("0x1a"));
var_dump(ctype_xdigit("1g"));
var_dump(ctype_xdigit("abc"));

bool(true)
bool(false)
bool(false)
bool(true)

Шестнадцатеричная запись использует 0–9 и A–F в обоих регистрах. Префикс 0x не проходит из-за x. Нечётное количество символов допустимо для ctype_xdigit, но может не подходить следующей операции.

<?php
function readRgbColor(mixed $raw): ?string
{
    if (!is_string($raw) || strlen($raw) !== 6 || !ctype_xdigit($raw)) {
        return null;
    }
    return "#" . strtolower($raw);
}
foreach (["A2B3C4", "abc", "#a2b3c4", "zzzzzz", ["A2B3C4"]] as $raw) {
    echo readRgbColor($raw) ?? "Нужны 6 HEX-символов", "\n";
}

#a2b3c4
Нужны 6 HEX-символов
Нужны 6 HEX-символов
Нужны 6 HEX-символов
Нужны 6 HEX-символов

Наше поле принимает ровно шесть HEX-символов без #. Это сознательно более узкое правило, чем все CSS-цвета. После проверки добавили # и унифицировали регистр. null обозначает отказ; ?? выбирает сообщение. Если цвет передают в query string с #, символ кодируют как %23: неэкранированный фрагмент URL серверу не отправляется. $_GET уже декодирован PHP; повторный urldecode не нужен.

<?php
$rawColor = "A2B3C4";
if (strlen($rawColor) === 6 && ctype_xdigit($rawColor)) {
    $cssColor = '#' . strtolower($rawColor);
    echo '<p>Цвет товара: <span style="display:inline-block;width:3em;height:1em;border:1px solid #333;background:',
        $cssColor, '"></span> ', $cssColor, '</p>';
} else {
    echo '<p>Нужно ровно 6 HEX-символов, например A2B3C4.</p>';
}

<p>Цвет товара: <span style="display:inline-block;width:3em;height:1em;border:1px solid #333;background:#a2b3c4"></span> #a2b3c4</p>

Сохраните как example.php и откройте через локальный PHP-сервер: появится цветной прямоугольник с подписью. В консоли вы увидите тот же HTML как текст. Функция сама ничего не рисует: она разрешает только шесть HEX-символов; PHP добавляет # и выдаёт HTML, браузер окрашивает span. Замените значение на FF8800 — образец станет оранжевым; zz8800 даст сообщение. Строгий список допустимых символов не позволяет вставить произвольный CSS в этот конкретный атрибут. Если значение приходит из формы, перед strlen отдельно проверьте is_string, как в предыдущем примере.

<?php
foreach (["4142", "abc", "41ZZ"] as $hex) {
    if (strlen($hex) > 64 || strlen($hex) % 2 !== 0 || !ctype_xdigit($hex)) {
        echo "Неверный HEX-пакет\n";
        continue;
    }
    $bytes = hex2bin($hex);
    if ($bytes === false) {
        throw new RuntimeException("Не удалось декодировать HEX");
    }
    echo bin2hex($bytes), "\n";
}

4142
Неверный HEX-пакет
Неверный HEX-пакет

% 2 вычисляет остаток деления длины: 0 означает пары символов. 41 и 42 — два байта; bin2hex показывает их безопасным текстом вместо произвольного двоичного вывода. Максимум 64 символа — правило нашего маленького пакета, не лимит PHP. Проверка не обещает, что пакет соответствует протоколу или подписи.