rfc:fpm:ini_syntax

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
rfc:fpm:ini_syntax [2010/04/15 12:05] fatrfc:fpm:ini_syntax [2013/10/29 17:31] – -> Implemented nikic
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.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1