Phar::offsetSet
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::offsetSet — Зміна вмісту файлу
Опис
public Phar::offsetSet(string $localName, resource|string $value): void
Зауваження :
Для коректної роботи з об'єктами Phar цьому методу необхідне встановлення значення php.ini
phar.readonly
в . В іншому випадку, буде викинуто виняток PharException
Це реалізація інтерфейсу ArrayAccessдозволяє маніпулювати вмістом Phar-архіву в стилі доступу до елементів масиву. offsetSet використовується для зміни контенту існуючого файлу або для створення нового.
Список параметрів
localName
Ім'я файлу (відносний шлях).
value
Вміст файлу.
Значення, що повертаються
Нічого не вертає.
Помилки
Якщо опція phar.readonlyустановлен в , то буде викинуто виняток BadMethodCallException, так як модифікувати Phar-архів можна тільки, якщо phar.readonly дорівнює . Якщо виникнуть якісь проблеми із записом на диск - викидається виняток PharException
Приклади
Приклад #1 Приклад використання Phar::offsetSet()****
offsetSet не потрібно викликати безпосередньо. Використовуйте синтаксис []
Loading...
Примітки
Зауваження Phar::addFile() Phar::addFromString()иPhar::offsetSet() зберігає новий phar-архів щоразу під час їхнього виклику. Якщо продуктивність викликає занепокоєння, натомість слід використовувати Phar::buildFromDirectory() або Phar::buildFromIterator()
Дивіться також
- Phar::offsetExists() - Визначити, чи є файл у архіві
- Phar::offsetGet() - Отримати PharFileInfo об'єкт для конкретного файлу
- Phar::offsetUnset() - Видалити файл із phar-архіву