Tester 2.6: updated documentation for php.ini loading behavior change

Author: dg

tester/cs/guide.texy

@@ -116,10 +116,9 @@ Výstup může vypadat takto:
 /--pre .[terminal]
  _____ ___  ___ _____ ___  ___
 |_   _/ __)( __/_   _/ __)| _ )
-  |_| \___ /___) |_| \___ |_|_\  v2.5.2
+  |_| \___ /___) |_| \___ |_|_\  v2.6.0
 
-Note: No php.ini is used.
-PHP 8.3.2 (cli) | php -n | 8 threads
+PHP 8.5.2 (cli) | php | 8 threads
 
 ........s................<span style="color: #FFF; background-color: #900">F</span>.........
 
@@ -160,7 +159,8 @@ Podporované verze PHP
 
 | verze            | kompatibilní s PHP
 |------------------|-------------------
-| Tester 2.5       | PHP 8.0 – 8.3
+| Tester 2.6       | PHP 8.0 – 8.5
+| Tester 2.5       | PHP 8.0 – 8.5
 | Tester 2.4       | PHP 7.2 – 8.2
 | Tester 2.3       | PHP 7.1 – 8.0
 | Tester 2.1 – 2.2 | PHP 7.1 – 7.3

tester/cs/running-tests.texy

@@ -23,10 +23,9 @@ Výstup může vypadat třeba takto:
 /--pre .[terminal]
  _____ ___  ___ _____ ___  ___
 |_   _/ __)( __/_   _/ __)| _ )
-  |_| \___ /___) |_| \___ |_|_\  v2.5.2
+  |_| \___ /___) |_| \___ |_|_\  v2.6.0
 
-Note: No php.ini is used.
-PHP 8.3.2 (cli) | php -n | 8 threads
+PHP 8.5.2 (cli) | php | 8 threads
 
 ........s..........................
 
@@ -37,9 +36,6 @@ Při opakovaném spuštění nejprve provádí testy, které při předchozím b
 
 Pokud žádný test neselže, návratový kód Testeru je nula. Jinak je návratový kód nenulový.
 
-.[warning]
-Tester spouští PHP procesy bez `php.ini`. Detailněji v části [#Vlastní php.ini].
-
 
 Parametry příkazové řádky
 =========================
@@ -56,8 +52,8 @@ Usage:
 
 Options:
     -p <path>                    Specify PHP interpreter to run (default: php).
-    -c <path>                    Look for php.ini file (or look in directory) <path>.
-    -C                           Use system-wide php.ini.
+    -c <path>                    Use custom php.ini, ignore system configuration.
+    -C                           With -c, include system configuration as well.
     -d <key=value>...            Define INI entry 'key' with value 'value'.
     -s                           Show information about skipped tests.
     --stop-on-fail               Stop execution upon the first failure.
@@ -86,12 +82,12 @@ tester -p /home/user/php-7.2.0-beta/php-cgi tests
 
 -c <path> .[filter]
 -------------------
-Určuje, který `php.ini` se bude používat při spouštění testů. Ve výchozím stavu se žádný php.ini nepoužije. Více v části [#Vlastní php.ini].
+Použije vlastní `php.ini` soubor a ignoruje systémovou konfiguraci. Více v části [#Vlastní php.ini].
 
 
 -C .[filter]
 ------------
-Použije se systémové `php.ini`. Na UNIXu také všechny příslušné INI soubory `/etc/php/{sapi}/conf.d/*.ini`. Více v části [#Vlastní php.ini].
+Při použití společně s `-c` zachová i systémovou konfiguraci (neignoruje ji). Více v části [#Vlastní php.ini].
 
 
 -d <key=value> .[filter]
@@ -221,11 +217,7 @@ Použijeme současně s volbou `--coverage`. `<path>` je cesta ke zdrojovým kó
 
 Vlastní php.ini
 ===============
-Tester spouští PHP procesy s parametrem `-n`, což znamená, že žádné `php.ini` není načteno. V UNIXu ani ty z `/etc/php/conf.d/*.ini`. To zajistí shodné prostředí pro běh testů, ale také vyřadí všechna PHP rozšíření běžně načtená systémovým PHP.
-
-Chcete-li načítání systémových php.ini souborů zachovat, použijte parametr `-C`.
-
-Pokud nějaká rozšíření nebo speciální INI nastavení pro testy potřebujete, doporučujeme vytvoření vlastního `php.ini` souboru, který bude distribuován s testy. Tester pak spouštíme s parametrem `-c`, například `tester -c tests/php.ini tests`, kde INI soubor může vypadat takto:
+Pro testy můžete použít vlastní `php.ini` soubor. Pokud potřebujete specifická rozšíření nebo speciální INI nastavení, doporučujeme vytvořit vlastní `php.ini`, který bude distribuován s testy. Tester pak spouštíme s parametrem `-c`, například `tester -c tests/php.ini tests`, kde INI soubor může vypadat takto:
 
 ```ini
 [PHP]
@@ -236,4 +228,7 @@ extension=php_pdo_pgsql.dll
 memory_limit=512M
 ```
 
-Spuštění Testeru v UNIXu se systémovým `php.ini`, například `tester -c /etc/php/cli/php.ini` nenačte ostatní INI z `/etc/php/conf.d/*.ini`. To je vlastnost PHP, ne Testeru.
+Při použití `-c` Tester **ignoruje systémovou konfiguraci** (spouští PHP s příznakem `-n`). Chcete-li zachovat i systémovou konfiguraci, přidejte volbu `-C`: `tester -c tests/php.ini -C tests`. Ani při kombinaci `-c` a `-C` se nenačtou v UNIXu ostatní INI soubory z `/etc/php/conf.d/*.ini`. To je vlastnost PHP, ne Testeru.
+
+.[note]
+Do verze 2.6 Tester bez uvedení `-c` spouštěl PHP s parametrem `-n`, tedy bez php.ini; volba `-C` toto potlačila. Od verze 2.6 se systémové php.ini načítá automaticky. Chování při použití `-c` zůstává stejné.

tester/en/guide.texy

@@ -116,10 +116,9 @@ The output may look like this:
 /--pre .[terminal]
  _____ ___  ___ _____ ___  ___
 |_   _/ __)( __/_   _/ __)| _ )
-  |_| \___ /___) |_| \___ |_|_\  v2.5.2
+  |_| \___ /___) |_| \___ |_|_\  v2.6.0
 
-Note: No php.ini is used.
-PHP 8.3.2 (cli) | php -n | 8 threads
+PHP 8.5.2 (cli) | php | 8 threads
 
 ........s................<span style="color: #FFF; background-color: #900">F</span>.........
 
@@ -160,7 +159,8 @@ Supported PHP versions
 
 | Version          | Compatible with PHP
 |------------------|-------------------
-| Tester 2.5       | PHP 8.0 – 8.3
+| Tester 2.6       | PHP 8.0 – 8.5
+| Tester 2.5       | PHP 8.0 – 8.5
 | Tester 2.4       | PHP 7.2 – 8.2
 | Tester 2.3       | PHP 7.1 – 8.0
 | Tester 2.1 – 2.2 | PHP 7.1 – 7.3

tester/en/running-tests.texy

@@ -23,10 +23,9 @@ The output may look like this:
 /--pre .[terminal]
  _____ ___  ___ _____ ___  ___
 |_   _/ __)( __/_   _/ __)| _ )
-  |_| \___ /___) |_| \___ |_|_\  v2.5.2
+  |_| \___ /___) |_| \___ |_|_\  v2.6.0
 
-Note: No php.ini is used.
-PHP 8.3.2 (cli) | php -n | 8 threads
+PHP 8.5.2 (cli) | php | 8 threads
 
 ........s..........................
 
@@ -37,9 +36,6 @@ When run again, it first executes the tests that failed in the previous run, so
 
 The Tester's exit code is zero if no test fails. Otherwise, it is non-zero.
 
-.[warning]
-The Tester runs PHP processes without `php.ini`. More details in the [#Own php.ini] section.
-
 
 Command-Line Options
 ====================
@@ -56,8 +52,8 @@ Usage:
 
 Options:
     -p <path>                    Specify PHP interpreter to run (default: php).
-    -c <path>                    Look for php.ini file (or look in directory) <path>.
-    -C                           Use system-wide php.ini.
+    -c <path>                    Use custom php.ini, ignore system configuration.
+    -C                           With -c, include system configuration as well.
     -d <key=value>...            Define INI entry 'key' with value 'value'.
     -s                           Show information about skipped tests.
     --stop-on-fail               Stop execution upon the first failure.
@@ -86,12 +82,12 @@ tester -p /home/user/php-7.2.0-beta/php-cgi tests
 
 -c <path> .[filter]
 -------------------
-Specifies which `php.ini` will be used when running tests. By default, no php.ini is used. See [#Own php.ini] for more information.
+Uses a custom `php.ini` file and ignores the system configuration. This is useful for running tests with specific settings. See [#Own php.ini] for more information.
 
 
 -C .[filter]
 ------------
-A system-wide `php.ini` is used. So on UNIX platform, all the `/etc/php/{sapi}/conf.d/*.ini` files too. See [#Own php.ini] section.
+When used together with `-c`, includes the system configuration as well (does not ignore it). See [#Own php.ini] section.
 
 
 -d <key=value> .[filter]
@@ -221,11 +217,7 @@ Used in conjunction with the `--coverage` option. `<path>` is the path to the so
 
 Own php.ini
 ===========
-Tester runs PHP processes with the `-n` option, which means that no `php.ini` is loaded (not even those from `/etc/php/conf.d/*.ini` on UNIX systems). This ensures a consistent environment for running tests, but it also disables all external PHP extensions normally loaded by the system's PHP.
-
-To preserve the loading of system php.ini files, use the `-C` parameter.
-
-If you need specific extensions or special INI settings for your tests, we recommend creating your own `php.ini` file and distributing it with your tests. Then, run Tester with the `-c` option, for example, `tester -c tests/php.ini tests`. The INI file might look like this:
+You can use a custom `php.ini` file for your tests. If you need specific extensions or special INI settings, we recommend creating your own `php.ini` file and distributing it with your tests. Then, run Tester with the `-c` option, for example, `tester -c tests/php.ini tests`. The INI file might look like this:
 
 ```ini
 [PHP]
@@ -236,4 +228,7 @@ extension=php_pdo_pgsql.dll
 memory_limit=512M
 ```
 
-Running Tester on UNIX with a system `php.ini`, like `tester -c /etc/php/cli/php.ini`, does not load other INIs from `/etc/php/conf.d/*.ini`. This is a PHP behavior, not specific to Tester.
+When using `-c`, Tester **ignores the system configuration** (runs PHP with `-n` flag). If you want to include system configuration as well, add the `-C` option: `tester -c tests/php.ini -C tests`. Even when combining `-c` and `-C`, other INI files from `/etc/php/conf.d/*.ini` are not loaded on UNIX. This is a PHP behavior, not specific to Tester.
+
+.[note]
+Prior to version 2.6, without `-c`, Tester ran PHP with `-n` flag, i.e., without php.ini; the `-C` option suppressed this. From version 2.6, system php.ini is loaded by default. The behavior when using `-c` remains unchanged.