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

<?php
const SHOP_CURRENCY = 'RUB';
echo SHOP_CURRENCY;

RUB

Имя после echo записано без кавычек: PHP находит связанную с ним строку. Запись echo 'SHOP_CURRENCY' напечатала бы название, а не RUB. Сохраните пример как example.php и выполните php example.php.

<?php
const SHOP_CURRENCY = 'RUB';
$teaPrice = 150;
$cupPrice = 200;
echo 'Чай: ', $teaPrice, ' ', SHOP_CURRENCY, "\n";
echo 'Чашка: ', $cupPrice, ' ', SHOP_CURRENCY, "\n";

Чай: 150 RUB
Чашка: 200 RUB

Первый echo читает 150 и RUB, второй — 200 и то же RUB. Изменение объявления перед новым запуском изменит обе подписи. Переменная teaPrice по-прежнему может меняться в ходе расчёта. Замена RUB на EUR здесь меняет только надпись: пересчёта валют программа не делает.

<?php
const DELIVERY_LIMIT = 3;
const delivery_limit = 7;
echo DELIVERY_LIMIT, "\n";
echo delivery_limit, "\n";

3
7

Это две разные константы. В рабочем коде такая пара неудобна: выбирайте содержательно разные имена. Встроенные true, false и null имеют особые правила; не выводите из них правило для пользовательских имён. Запятые в echo выводят части по очереди, "\n" означает перевод строки.

<?php
const PAGE_SIZE = 12;
$page = 1;
echo $page, ': ', PAGE_SIZE, "\n";
$page = 2;
echo $page, ': ', PAGE_SIZE, "\n";

1: 12
2: 12

Присваивание меняет page, оба чтения PAGE_SIZE дают 12. У константы нет обычного переназначения через = и удаления через unset. Для следующей страницы меняется переменная, а не правило размера.

<?php
const LIMIT = 12;
$LIMIT = 5;
echo LIMIT, "\n";
echo $LIMIT, "\n";

12
5

Переменная $LIMIT не заменяет константу LIMIT. Технически допустимо, но лучше назвать её $requestedCount, чтобы различие было видно по смыслу.

<?php
const MINUTES_PER_RUN = 5;
const SECONDS_PER_MINUTE = 60;
const RUN_TIMEOUT_SECONDS = MINUTES_PER_RUN * SECONDS_PER_MINUTE;
echo RUN_TIMEOUT_SECONDS;

300

Вычисляется произведение, после чего читается значение правила. Скрипт от этого сам не остановится через 300 секунд: число ещё нужно передать инструменту, который ограничивает операцию.

<?php
$configuredPageSize = 15;
define('CONFIGURED_PAGE_SIZE', $configuredPageSize);
echo CONFIGURED_PAGE_SIZE;

15

Имя в кавычках нужно для аргумента define; чтение результата опять записано без кавычек. Настройка здесь заведомо корректна. Внешний ввод сначала нужно проверить, поскольку define не знает допустимый размер страницы.

<?php
declare(strict_types=1);

const PAGE_SIZE = 3;

$catalogCount = 7;
$archiveCount = 4;
echo 'Каталог: ', intdiv($catalogCount + PAGE_SIZE - 1, PAGE_SIZE), " страницы\n";
echo 'Архив: ', intdiv($archiveCount + PAGE_SIZE - 1, PAGE_SIZE), " страницы\n";

Каталог: 3 страницы
Архив: 2 страницы

Оба расчёта читают одно PAGE_SIZE. Число записей меняется, правило размера страницы — нет. intdiv делит целые числа без дробной части; прибавление PAGE_SIZE − 1 округляет число страниц вверх. Поменяйте PAGE_SIZE на 4: каталог даст 2, архив — 1. Здесь размеры известны и положительны.

<?php
const PAGE_SIZE = 3;
$products = ['Чай', 'Кофе', 'Кружка', 'Тарелка', 'Ложка', 'Сахар', 'Мёд'];
$pages = array_chunk($products, PAGE_SIZE);
foreach ($pages as $index => $items) {
    echo 'Страница ', $index + 1, ":\n";
    foreach ($items as $title) {
        echo '- ', $title, "\n";
    }
}

Страница 1:
- Чай
- Кофе
- Кружка
Страница 2:
- Тарелка
- Ложка
- Сахар
Страница 3:
- Мёд

Array_chunk получает семь названий и размер 3; возвращает три вложенных списка. Внешний foreach последовательно получает items из трёх, трёх и одного названия. Каждый внутренний echo читает реальный товар. При PAGE_SIZE=4 получатся страницы из четырёх и трёх товаров. Пустой products даёт пустой pages: цикл ничего не выводит. Здесь весь список уже в памяти; большие выборки из базы обычно ограничивают на стороне запроса.

<?php
declare(strict_types=1);

const EXPORT_PAGE_SIZE = 3;

// Учебное значение. В приложении настройку сначала читают и проверяют.
$configuredFormat = 'json';
if (!in_array($configuredFormat, ['json', 'csv'], true)) {
    throw new InvalidArgumentException('Неподдерживаемый формат');
}
if (!defined('BRIDGE_EXPORT_FORMAT')) {
    define('BRIDGE_EXPORT_FORMAT', $configuredFormat);
}

function exportPlan(int $itemCount): string
{
    if ($itemCount < 0) {
        throw new InvalidArgumentException('Отрицательное число записей');
    }
    $pages = intdiv($itemCount + EXPORT_PAGE_SIZE - 1, EXPORT_PAGE_SIZE);
    return BRIDGE_EXPORT_FORMAT . ': ' . $pages . ' страниц';
}

echo exportPlan(7), "\n";
echo exportPlan(0), "\n";
try {
    exportPlan(-1);
} catch (InvalidArgumentException) {
    echo "Неверное количество отклонено\n";
}

json: 3 страниц
json: 0 страниц
Неверное количество отклонено

defined получает имя строкой и проверяет существование; define объявляет значение во время выполнения. Функция читает уже объявленные константы без global. Это только план: ни JSON-файл, ни сетевой запрос здесь не создаются. Проверка defined полезна для необязательной настройки, но не должна скрывать конфликт двух разных конфигураций.

<?php
function readStock(): string {
    $path = __DIR__ . '/fixtures/stock.txt';
    $body = file_get_contents($path);
    if ($body === false) { throw new RuntimeException('Учебный файл недоступен'); }
    return __FUNCTION__ . ': ' . trim($body);
}
echo readStock(), "\n";
echo 'Исходный файл: ', basename(__FILE__), "\n";
echo 'Метка строки: ', __LINE__, "\n";

readStock: 12
Исходный файл: example.php
Метка строки: 10

Вызов readStock() получает текст 12 из приложенного файла. __FUNCTION__ добавляет имя readStock, return передаёт готовую строку внешнему echo. __DIR__ привязывает путь к папке программы независимо от каталога запуска терминала. __FILE__ содержит полный путь; basename делает подпись переносимой. __LINE__ показывает настоящий номер строки в этом файле, а не проверку «номер больше нуля». При добавлении строк номер закономерно изменится; при переименовании example.php изменится имя. Файл запаса читается, но не изменяется.

<?php
if (!defined('EXPORT_BATCH_SIZE')) {
    define('EXPORT_BATCH_SIZE', 20);
}
echo EXPORT_BATCH_SIZE;

20

Guard подходит для документированной возможности переопределения. При случайном конфликте двух файлов он скрывает проблему: останется значение первого. Для строгой конфигурации конфликт нужно обнаруживать.

<?php
try {
    echo UNKNOWN_DELIVERY_RULE;
} catch (Error $error) {
    echo "Нет объявления константы\n";
}

Нет объявления константы

На старых PHP встречалось предупреждение и использование неизвестного имени как строки. В PHP 8 проверьте имя, порядок подключений и namespace.

<?php
const EXPORT_FORMATS = ['csv', 'json'];
$formatsForReport = EXPORT_FORMATS;
$formatsForReport[] = 'txt';
echo "Общее правило:\n";
foreach (EXPORT_FORMATS as $format) { echo '- ', $format, "\n"; }
echo "Этот отчёт:\n";
foreach ($formatsForReport as $format) { echo '- ', $format, "\n"; }

Общее правило:
- csv
- json
Этот отчёт:
- csv
- json
- txt

Присваивание копирует значение массива в formatsForReport. Запись [] добавляет txt в изменяемую копию. Два foreach показывают сами элементы: исходное правило по-прежнему csv/json, рабочий список csv/json/txt. Это ещё перечень разрешённых названий, а не реализация кодирования этих форматов. Запись EXPORT_FORMATS[] = ... запрещена. Если массив содержит объекты, их внутреннее состояние требует отдельного разбора: копирование массива не клонирует объекты.

<?php
const ITEMS_PER_BOX = 6;
function twoBoxes(): int {
    return ITEMS_PER_BOX * 2;
}
$available = twoBoxes();
$reserved = 5;
$remaining = $available - $reserved;
echo 'В двух коробках: ', $available, "\n";
echo 'Зарезервировано: ', $reserved, "\n";
echo 'Осталось: ', $remaining, "\n";

В двух коробках: 12
Зарезервировано: 5
Осталось: 7

Вызов справа от = входит в twoBoxes. Тело читает ITEMS_PER_BOX=6, умножает на 2 и возвращает 12 точно в выражение twoBoxes(). Присваивание сохраняет 12 в available; следующая арифметика использует его для 12−5=7. Return сам ничего не печатает. Global для чтения константы не нужен. Если на двух складах разная вместимость, передайте её параметром вместо одного общего имени.

<?php
function registerExportLimit(): void
{
    define('FUNCTION_EXPORT_LIMIT', 25);
}
registerExportLimit();
echo FUNCTION_EXPORT_LIMIT;

25

До вызова имени ещё нет. Повторный вызов попытался бы объявить его снова: предупреждение, старое значение останется. void означает отсутствие полезного возвращаемого значения. Такой шаблон не подходит для разных параметров каждого заказа.

<?php
namespace Lesson\Catalog;
const PAGE_LIMIT = 12;
define('OUTSIDE_LIMIT', 4);
define(__NAMESPACE__ . '\\DYNAMIC_LIMIT', 8);
echo PAGE_LIMIT, "\n";
echo \OUTSIDE_LIMIT, "\n";
echo constant('Lesson\\Catalog\\DYNAMIC_LIMIT'), "\n";

12
4
8

__NAMESPACE__ даёт префикс, точка соединяет строки. OUTSIDE_LIMIT объявлен глобально. Для define передавайте полное имя без ведущего обратного слеша. constant читает значение по готовому строковому имени.

<?php
require __DIR__ . '/rules.php';
echo \Lesson\Shipping\MAX_PARCELS;

3

require выполняет приложенный rules.php, namespace только организует имена. Обычная автозагрузка классов сама не загружает свободные константы и функции. В Composer их файлы можно явно перечислить в autoload.files; классам подходит PSR-4.

<?php
namespace Shop\Catalog {
    const BASE_PATH = '/catalog/';
    const OFFERS_PATH = BASE_PATH . 'offers/';
}
namespace Shop\Delivery {
    define(__NAMESPACE__ . '\\BASE_PATH', '/delivery/');
    define(__NAMESPACE__ . '\\OFFERS_PATH', BASE_PATH . 'offers/');
}
namespace {
    echo 'Каталог: ', \Shop\Catalog\OFFERS_PATH, "\n";
    echo 'Доставка: ', constant('Shop\\Delivery\\OFFERS_PATH'), "\n";
}

Каталог: /catalog/offers/
Доставка: /delivery/offers/

В Catalog константное выражение складывает две строки точкой; результат /catalog/offers/. В Delivery __NAMESPACE__ даёт Shop\Delivery, добавление \BASE_PATH формирует имя для define. Следующий вызов читает собственный BASE_PATH и строит /delivery/offers/. В глобальном коде прямое полное имя и constant по строке получают готовые значения. Эти пути ещё не создают страницы сайта. Пространство не добавляется к строкам define автоматически; без префикса возникли бы общие глобальные имена.

<?php
$preparedBytes = 2000000000;
$nextBatchBytes = 100000000;
if ($nextBatchBytes > PHP_INT_MAX - $preparedBytes) {
    echo "Размер не помещается в целое этой сборки PHP\n";
} else {
    $totalBytes = $preparedBytes + $nextBatchBytes;
    echo 'После партии: ', $totalBytes, ' байт', "\n";
}
if (PHP_VERSION_ID >= 80200) {
    echo "Можно запустить утилиту для PHP 8.2+\n";
}

После партии: 2100000000 байт
Можно запустить утилиту для PHP 8.2+

PHP_INT_MAX даёт верхнюю границу int именно этой сборки. Ветвь else получает суммарные 2100000000 байт и печатает их; выбранное число помещается и в 32-, и в 64-битный int. Если прибавление не помещается, сложение не выполняется. 80200 обозначает 8.2.0: проверка версии разрешает сообщение о минимальном требовании, но не проверяет срок поддержки или расширения. Эти имена уже предоставляет PHP, объявлять их самостоятельно не нужно. Для отрицательных входов или уже полученного float эта проверка не является готовым универсальным алгоритмом.

<?php
class BaseReport
{
    public static function identify(): void
    {
        echo __CLASS__, "\n";
        echo __METHOD__, "\n";
        echo static::class, "\n";
    }
}
class StockReport extends BaseReport {}
StockReport::identify();

BaseReport
BaseReport::identify
StockReport

Это пример после главы наследования: extends создаёт потомка, :: вызывает статический метод. __CLASS__/__METHOD__ описали исходное объявление, static::class — вызвавший класс. Так в журнале различают «где написан код» и «от чьего имени он работает».

<?php
namespace Lesson;
trait DescribeContext
{
    public function describe(): void
    {
        echo __TRAIT__, "\n";
        echo __CLASS__, "\n";
        echo __METHOD__, "\n";
        echo __FUNCTION__, "\n";
        echo __NAMESPACE__, "\n";
    }
}
class DeliveryClient { use DescribeContext; }
(new DeliveryClient())->describe();

Lesson\DescribeContext
Lesson\DeliveryClient
Lesson\DescribeContext::describe
describe
Lesson

use внутри класса подключает трейт, а не импортирует namespace. Подписи различают источник метода и получивший его класс. Они не доказывают, что доставка или запрос прошли успешно: для этого нужен результат операции.

<?php
class Parcel
{
    public int $weight {
        set {
            echo __PROPERTY__, "\n";
            $this->weight = $value;
        }
    }
}
$parcel = new Parcel();
$parcel->weight = 1200;
echo $parcel->weight;

weight
1200

Нужна глава свойств и property hooks: set перехватывает запись, value содержит новое значение. __PROPERTY__ обозначает weight. Здесь демонстрируется контекст, а не законченная модель посылки: единицы и допустимые значения проверяются отдельно. Синтаксис требует PHP 8.4+.

<?php
class DeliveryRule
{
    public int $limit = 3;
}
const DELIVERY_RULE = new DeliveryRule();
$rule = DELIVERY_RULE;
$rule->limit = 4;
echo DELIVERY_RULE->limit;

4

rule указывает на тот же объект. Константу не переназначали, но свойство изменили. Для фиксированного числа проще скаляр; для объекта нужны продуманные правила изменения и доступа. clone создаёт другой объект с отдельными ограничениями глубины копии.

<?php
const RETRY_STEPS = (int) 3.8;
echo RETRY_STEPS;

3

Дробная часть отброшена. Обычно проще сразу записать целое 3; пример показывает допустимый синтаксис для чтения библиотек, а не проверку пользовательского ввода.

<?php
const LABEL_FORMATTER = static function (string $label): string {
    return '[' . $label . ']';
};
$format = LABEL_FORMATTER;
echo $format('SKU-17');

[SKU-17]

Константа хранит Closure. Присваивание даёт это значение format. Скобки после $format запускают функцию: аргумент становится label, return возвращает [SKU-17] в место вызова, echo выводит результат.

<?php
const LABEL_LENGTH = strlen(...);
$measure = LABEL_LENGTH;
echo $measure('SKU-17');

6

Три точки создают first-class callable; strlen ещё не вызывается. Запуск происходит через $measure. strlen считает байты, поэтому для кириллицы метрику выбирают отдельно.