Phar::buildFromDirectory
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::buildFromDirectory — Створює phar-архів із файлів, розташованих усередині директорії
Опис
public Phar::buildFromDirectory(string $directory, string $pattern = ""): array
Зауваження :
Для коректної роботи з об'єктами Phar цьому методу необхідне встановлення значення php.ini
phar.readonly
в . В іншому випадку, буде викинуто виняток PharException
Заповнює phar-архів вмістом директорії. Необов'язковий другий параметр є регулярним виразом (PCRE) та використовується для виключення файлів. Будь-який файл, ім'я якого відповідає регулярному виразу, буде включений, всі інші будуть виключені. Для більш детального контролю використовуйте Phar::buildFromIterator()
Список параметрів
directory
Повний або абсолютний шлях до директорії, всі файли якої мають бути додані до архіву.
pattern
Необов'язковий регулярний вираз (PCRE), який використовується для фільтрації списку файлів. До архіву будуть включені лише ті файли, шляхи до яких відповідають регулярному виразу.
Значення, що повертаються
Phar::buildFromDirectory() повертає асоціативний масив, в якому відображено відповідність шляху до файлу всередині архіву до шляху до файлу у файловій системі.
Помилки
Цей метод викидає виняток BadMethodCallException у разі, якщо не вдалося створити примірник ітератора внутрішніх директорій. Виняток PharException викидається у разі помилок збереження phar-архіву.
список змін
Версия | Опис |
---|---|
8.1.0 | Phar::buildFromDirectory() більше не повертає значення false |
Приклади
Приклад #1 Приклад використання Phar::buildFromDirectory()****
Loading...
Дивіться також
- Phar::buildFromIterator() - Створює phar-архів із ітератора