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 12:05]
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
  
Line 27: 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 38: 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 61: 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 66: Line 64:
   * **listen.group**.   * **listen.group**.
   * **listen.mode**.   * **listen.mode**.
 +  * **listen.allowed_client**.
   * **ping.path**.   * **ping.path**.
   * **ping.response**.   * **ping.response**.
Line 75: Line 74:
   * **rlimit_core**.   * **rlimit_core**.
   * **rlimit_files**.   * **rlimit_files**.
-  * **max_requests**. 
   * **catch_worker_output**.   * **catch_worker_output**.
   * **php_value[]**.   * **php_value[]**.
Line 81: 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 95: 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 101: 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 116: Line 110:
   * 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-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.1271333110.txt.gz · Last modified: 2017/09/22 13:28 (external edit)