rfc:fpm:ini_syntax

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
rfc:fpm:ini_syntax [2010/04/15 10:15]
fat
rfc:fpm:ini_syntax [2017/09/22 13:28] (current)
Line 1: Line 1:
 ====== Request for Comments: FPM INI Syntax ====== ====== Request for Comments: FPM INI Syntax ======
-  * Version: 1.1 +  * Version: 1.2 
-  * Date: 2010-04-13+  * Date: 2010-04-21
   * Author: Jérôme Loyet <​jerome.at.loyet.dot.net>​   * Author: Jérôme Loyet <​jerome.at.loyet.dot.net>​
-  * Status: ​Under Discussion+  * Status: ​Implemented in PHP 5.3
   * First Published at: http://​wiki.php.net/​rfc/​fpm/​ini_syntax   * First Published at: http://​wiki.php.net/​rfc/​fpm/​ini_syntax
  
 This RFC discusses the FPM configuration file syntax and it's replacement from XML to INI. This RFC discusses the FPM configuration file syntax and it's replacement from XML to INI.
 +
 +**WE ARE NOT TALKING HERE ABOUT CHANGING SOMETHING INTO main/* or Zend/*.
 +This dicussion is about sapi/fpm ONLY**
  
 ===== Introduction ===== ===== Introduction =====
Line 24: Line 27:
     * specific simple directives (user=, group=, status=, ...)     * specific simple directives (user=, group=, status=, ...)
     * specific array directives (environment[PATH]=,​ php_define[sendmail_path]=,​ ...)     * specific array directives (environment[PATH]=,​ php_define[sendmail_path]=,​ ...)
-  * A reference system. A worker can be set as a reference and it'll never be instantiated. Classic workers can use it to define default values. For exemple, timeout directives are set once in a reference worker and normal workers will use this worker as a reference. 
  
 ===== Implementation ===== ===== Implementation =====
Line 35: Line 37:
 php_define[sendmail_path] = /​bin/​mini_sendmail -t -i -fwww@my.site.com</​code>​ php_define[sendmail_path] = /​bin/​mini_sendmail -t -i -fwww@my.site.com</​code>​
   * Workers starts with a INI section. The value of the section is named with the worker'​s name. All the following directives are related to this worker until another INI section starts a new worker.<​code>​[www.my.site.com]</​code>​   * Workers starts with a INI section. The value of the section is named with the worker'​s name. All the following directives are related to this worker until another INI section starts a new worker.<​code>​[www.my.site.com]</​code>​
-    * The directive **is_a_reference** set the current worker as a reference. It can be set to yes or no. <​code>​is_a_reference=yes ​  ; incompatible with reference</​code>​ 
-    * The directive **reference** set the worker to use as a reference. It's named **reference** and can be set to any worker set as a reference by **is_a_reference**. <​code>​reference=default ​  ; incompatible with is_a_reference</​code>​ 
  
 ===== Yet known directives ===== ===== Yet known directives =====
Line 58: Line 58:
   * **pm.max_requests**.   * **pm.max_requests**.
   * **pm.status_path**.   * **pm.status_path**.
 +  * **pm.max_requests**.
   * **listen.address**.   * **listen.address**.
   * **listen.backlog**.   * **listen.backlog**.
Line 63: Line 64:
   * **listen.group**.   * **listen.group**.
   * **listen.mode**.   * **listen.mode**.
 +  * **listen.allowed_client**.
   * **ping.path**.   * **ping.path**.
   * **ping.response**.   * **ping.response**.
Line 72: Line 74:
   * **rlimit_core**.   * **rlimit_core**.
   * **rlimit_files**.   * **rlimit_files**.
-  * **max_requests**. 
   * **catch_worker_output**.   * **catch_worker_output**.
   * **php_value[]**.   * **php_value[]**.
Line 78: Line 79:
   * **php_flag[]**.   * **php_flag[]**.
   * **php_admin_flag[]**.   * **php_admin_flag[]**.
-  * **allowed_client[]**. 
   * **env[]**.   * **env[]**.
-===== Not yet known directives ===== 
   * **include**.   * **include**.
-  * **reference**. 
-  * **is_a_reference**. 
 ===== Rename directive proposal ===== ===== Rename directive proposal =====
 In this section, I want to propose to rename some of the yet know directives. In this section, I want to propose to rename some of the yet know directives.
Line 92: Line 89:
   * **status** to **pm.status_path**. The status directive is directly related to PM as it's its status page.   * **status** to **pm.status_path**. The status directive is directly related to PM as it's its status page.
   * **listen_address** to **listen.address**   * **listen_address** to **listen.address**
 +  * **allowed_clients** to **listen.allowed_clients**
   * **ping** and **pong** to a subsection:   * **ping** and **pong** to a subsection:
     * **ping.path** to set the ping path request (/ping)     * **ping.path** to set the ping path request (/ping)
Line 98: Line 96:
   * **environment[]** to **env[]**. The short word env is enough to understand and closer to reality (env shell command).   * **environment[]** to **env[]**. The short word env is enough to understand and closer to reality (env shell command).
   * **php_define[]** to **php_flag[]**,​ **php_value[]**,​ **php_admin_flag[]**,​ **php_admin_value[]**. This is the same syntax as the apache sapi.   * **php_define[]** to **php_flag[]**,​ **php_value[]**,​ **php_admin_flag[]**,​ **php_admin_value[]**. This is the same syntax as the apache sapi.
-  * **allowed_clients** to **allowed_client[]** as there could be more than one allowed client. 
  
 ===== Examples ===== ===== Examples =====
Line 112: Line 109:
   * fat - 2010-04-13 - remove unnecessary use of arrays (for pm, ping and listen) + add examples   * fat - 2010-04-13 - remove unnecessary use of arrays (for pm, ping and listen) + add examples
   * fat - 2010-04-15 - first revision of the patch has been added   * fat - 2010-04-15 - first revision of the patch has been added
 +  * fat - 2010-04-15 - add warning header to explain this RFC is only about sapi/fpm/*
 +  * fat - 2010-04-21 - commit the patch (revision 298281)
rfc/fpm/ini_syntax.1271326528.txt.gz · Last modified: 2017/09/22 13:28 (external edit)