From 6637367d43e5d1c1fdad41eefbd84097c044fe8a Mon Sep 17 00:00:00 2001
From: AnthonyAxenov <anthonyaxenov@gmail.com>
Date: Fri, 2 Sep 2022 21:24:51 +0800
Subject: [PATCH] =?UTF-8?q?=D0=A3=D1=82=D0=BE=D1=87=D0=BD=D0=B5=D0=BD?=
 =?UTF-8?q?=D0=B8=D1=8F=20=D0=BF=D0=BE=20README=20=D0=B8=20php.ini?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md          | 38 ++++++++++++++++++++++++++++++--------
 docker/php/php.ini | 24 +++++++++++++++---------
 2 files changed, 45 insertions(+), 17 deletions(-)

diff --git a/README.md b/README.md
index 5777a40..7df9eb5 100644
--- a/README.md
+++ b/README.md
@@ -146,7 +146,8 @@ GET https://iptv.axenov.dev/<ID>/json
 * `status` -- статус плейлиста (`"online"|"timeout"|"offline"|"error"`)
 * `encoding` -- данные о кодировке файла плейлиста
     * `name` -- название кодировки (`"UTF-8"|"Windows-1251"`)
-    * `alert` -- признак отличия кодировки от `UTF-8`, названия каналов сконвертированы в `UTF-8`, могут быть ошибки в отображении
+    * `alert` -- признак отличия кодировки от `UTF-8`, названия каналов сконвертированы в `UTF-8`, могут быть ошибки
+    в отображении
 * `channels` -- массив названий каналов
 * `count` -- количество каналов >= 0
 
@@ -193,7 +194,7 @@ GET https://iptv.axenov.dev/<ID>/json
 
 ### Вручную
 
-1. Выполнить `cp src/.env.example src/.env`, установить необходимые параметры в файле `src/.env`
+1. Выполнить `cp ./src/.env.example ./src/.env`, установить необходимые параметры в файле `./src/.env`
 2. Выполнить `docker compose up -d --build` (или `./iptv up`)
 3. Открыть `http://<APP_URL>:8080` в браузере (или `./iptv open`)
 
@@ -246,13 +247,28 @@ $ sudo systemctl restart apache2
 
 <a id="tools"></a>
 
-## Дополнительные инструменты (`./tools`)
+## Дополнительные инструменты
 
-### `download-all.sh`
+### Очистка кеша Twig
+
+Если в файле `./src/.env` параметр `TWIG_CACHE=1`, то макеты страниц компилируются однажды и потом переиспользуются.
+Изменённые макеты не будут перекомпилироваться пока не будет очищен кеш прежних.
+
+Для этого следует выполнить:
+
+```
+./iptv composer clear-views
+```
+
+### Скачать все плейлисты
+
+Команда: `./tools/download-all.sh`
 
 Скачивает все плейлисты из [`playlists.ini`](playlists.ini) в локальную директорию `./downloaded/`.
 
-### `check-pls.sh`
+### Проверить каналы плейлиста
+
+Команда: `./tools/check-pls.sh`
 
 Проверяет каждый канал в плейлисте на доступность и выводит результат проверки.
 
@@ -291,7 +307,9 @@ Check stats
 - Failed:       4/999
 ```
 
-### `find-in-pls.sh`
+### Поиск каналов в одном плейлисте
+
+Команда: `./tools/find-in-pls.sh`
 
 Находит каналы по заданному регулярному выражению в одном указанном плейлисте.
 
@@ -317,7 +335,9 @@ Channel found: disney
 Found: 2
 ```
 
-### `find-in-all.sh`
+### Поиск каналов во всех плейлистах
+
+Команда: `./tools/find-in-all.sh`
 
 Находит каналы по заданному регулярному выражению во всех плейлистах, скачанных через `download-all.sh`.
 
@@ -351,7 +371,9 @@ Nothing found
 ...
 ```
 
-### `make-pls.sh`
+### Создать плейлист из нужных каналов
+
+Команда: `./tools/make-pls.sh`
 
 Находит каналы по заданному регулярному выражению во всех плейлистах, скачанных через `download-all.sh`.
 
diff --git a/docker/php/php.ini b/docker/php/php.ini
index f87b81b..548dc37 100644
--- a/docker/php/php.ini
+++ b/docker/php/php.ini
@@ -1,9 +1,8 @@
 [PHP]
-file_uploads = Off
-; upload_max_filesize=256M
-; post_max_size=256M
 error_reporting = E_ALL
-;& ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING
+file_uploads = Off
+; upload_max_filesize=10M
+; post_max_size=10M
 
 [opcache]
 opcache.enable = 1
@@ -16,12 +15,19 @@ opcache.jit = tracing
 
 [xdebug]
 ; https://xdebug.org/docs/all_settings
+
+; закомментировать для выключения
 zend_extension = xdebug.so
-xdebug.mode = develop,debug
+
+; для отладки установить значение 'develop,debug'
+xdebug.mode = develop
+
+; для отладки при каждом запросе поменять 'trigger' на 'yes'
+; иначе -- отправлять заголовок 'Cookie: XDEBUG_TRIGGER=go'
+xdebug.start_with_request = trigger
+xdebug.trigger_value = go
+
+xdebug.client_host = 172.17.0.1
 xdebug.REQUEST = *
 xdebug.SESSION = *
 xdebug.SERVER = *
-xdebug.client_host = 172.17.0.1
-;xdebug.start_with_request=yes
-xdebug.start_with_request = trigger
-xdebug.trigger_value = go