├── 1.NameSpace.md
├── 2.Interface.md
├── 3.Generators.md
├── 4.Closures.md
├── 5.ZendOpcache.md
├── 6.Built-in-server.md
├── 7.FIG_and_PSR.md
├── 8.Components.md
├── 9.BestPractices.md
├── README.md
├── X.Hosting.md
├── XI.PHP-FPM.md
└── XII.Tuning-Deploy-Test-HHVM.md


/1.NameSpace.md:
--------------------------------------------------------------------------------
  1 | namespace 定义在 php文件顶部紧挨着 `<?php` 的下一行，顶级namespace必须全局唯一。
  2 | 
  3 | ```php
  4 | <?php
  5 | namespace Oreilly;
  6 | ```
  7 | 
  8 | sub-namespaces
  9 | 
 10 | ```php
 11 | <?php
 12 | namespace Oreilly\ModernPHP
 13 | ```
 14 | 
 15 | 属于同个namespace的类不一定非得定义在一个文件下。可在每个文件顶部使用同一个namespace以标记这些文件在同一个命名空间下。
 16 | 
 17 | 在php 引入 namespace之前，php开发者们使用 Zend-style 的类命名方式（源自 Zend 框架）。
 18 | 
 19 | 即使用下划线来表示目录分隔，autoloader时自动替换下划线为当前OS的目录分隔符
 20 | 
 21 | ```php
 22 | # Zend_Cloud_DocumentService_Adapter_WindowsAzure_Query => Zend/Cloud/DocumentService/Adapter/WindowsAzure/Query.php
 23 | ```
 24 | 
 25 | 这种方式对懒人来说的缺点就是写很多类名时太TM长了。
 26 | 
 27 | namespace提供了 import和 alias来解决这个问题。
 28 | 
 29 | import，alias 在5.3版本下支持类，接口与命名空间导入。5.6开始支持函数与常量导入。
 30 | 
 31 | ```php
 32 | # namespace without alias
 33 | <?php
 34 | $response = new \Symfony\Component\HttpFoundation\Response('Oops',400);
 35 | $response->send();
 36 | $response2 = new \Symfony\Component\HttpFoundation\Response('Success',200);
 37 | ```
 38 | 
 39 | ```php
 40 | # namespace with alias 
 41 | use Symfony\Component\HttpFoundation\Response;
 42 | $response ＝ new Response('Oops',400);
 43 | $response->send();
 44 | ```
 45 | 
 46 | ```php
 47 | # namespace with custom alias 
 48 | use Symfony\Component\HttpFoundation\Response as Res;
 49 | $response ＝ new Res('Oops',400);
 50 | $response->send();
 51 | ```
 52 | 
 53 | import与 alias的use与namespace的规则一样要在 php文件顶部紧挨着 `<?php` 的下一行或namespace的定义之后。
 54 | 
 55 | 你没有必要在导入的命名空间的开始处加上`\`，php默认导入的命名空间为完全限定名称。
 56 | 
 57 | use关键字必须存在于全局作用域，因为它是在编译时被处理。
 58 | 
 59 | 5.6之后可以导入函数与常量示例：
 60 | 
 61 | ```php
 62 | <?php
 63 | use func Namespace\functionName;
 64 | functionName();
 65 | ```
 66 | 
 67 | ```php
 68 | <?php
 69 | use constant Namespace\CONST_NAME;
 70 | echo CONST_NAME;
 71 | ```
 72 | 多个namespace在一个文件中（这种做法极度不推荐）
 73 | 
 74 | ```php
 75 | <?php
 76 | namespace Foo{
 77 | 
 78 | }
 79 | 
 80 | namespace Bar{
 81 | 
 82 | }
 83 | ```
 84 | 
 85 | 若没有附带namespace的调用类，方法或常量。php会默认这些属于当前命名空间下。
 86 | 
 87 | 如果想指定namespace，则要使用完全限定名称来调用，或使用use来导入。
 88 | 
 89 | ```php
 90 | <?php
 91 | namespace My\App
 92 | ＃ Unqualified class name inside another namespace
 93 | class Foo {
 94 |     public function doSomething() {
 95 |         $exception = new Exception(); // php will search \My\App\Exception
 96 |     }
 97 | }
 98 | ```
 99 | 
100 | ```php
101 | <?php
102 | namespace My\App
103 | ＃ Qualified class name inside another namespace
104 | class Foo {
105 |     public function doSomething() {
106 |         $exception = new \Exception(); // php will search \Exception
107 |     }
108 | }
109 | ```
110 | 
111 | [namespace 官方手册参考](http://php.net/manual/en/language.namespaces.php) 
112 | 
113 | PS：中文版手册该章节有错误，请以英文版为准。
114 | 


--------------------------------------------------------------------------------
/2.Interface.md:
--------------------------------------------------------------------------------
  1 | 无规矩不成方圆。你如果有一组类有类似的“行为”，需要对他们进行约束的话，接口就必不可少了。
  2 | 
  3 | 只要定好规范，任第三份随意实现其代码。但是调用逻辑是不变的。
  4 | 
  5 | 所以即使以后更换组件，只要其正确实现了所需接口，逻辑层代码都不需要变化。
  6 | 
  7 | ```php
  8 | # Example
  9 | class DocumentStore {
 10 |     protected $data = [];
 11 |     public function addDocument(Documentable $document) {
 12 |         $key = $document->getId();
 13 |         $value = $document->getContent();
 14 |         $this->data[$key] = $value;
 15 |     }
 16 |     public function getDocuments() {
 17 |         return $this->data; 
 18 |     }
 19 | }
 20 | 
 21 | interface Documentable {
 22 |     public function getId(); 
 23 |     public function getContent();
 24 | }
 25 | 
 26 | class HtmlDocument implements Documentable {
 27 |     protected $url;
 28 |     public function __construct($url) {
 29 |         $this->url = $url;
 30 |     }
 31 |     public function getId() {
 32 |         return $this->url; 
 33 |     }
 34 |     public function getContent() {
 35 |         $ch = curl_init();
 36 |         curl_setopt($ch, CURLOPT_URL, $this->url);
 37 |         curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 38 |         curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
 39 |         curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
 40 |         curl_setopt($ch, CURLOPT_MAXREDIRS, 3);
 41 |         $html = curl_exec($ch);
 42 |         curl_close($ch);
 43 |         return $html; 
 44 |     }
 45 | }
 46 | 
 47 | class StreamDocument implements Documentable {
 48 |     protected $resource; protected $buffer;
 49 |     public function __construct($resource, $buffer = 4096) {
 50 |         $this->resource = $resource;
 51 |         $this->buffer = $buffer;
 52 |     }
 53 |     public function getId() {
 54 |         return 'resource-' . (int)$this->resource; 
 55 |     }
 56 |     public function getContent() {
 57 |         $streamContent = ''; rewind($this->resource);
 58 |         while (feof($this->resource) === false) {
 59 |             $streamContent .= fread($this->resource, $this->buffer);
 60 |         }
 61 |         return $streamContent; 
 62 |     }
 63 | }
 64 | 
 65 | class CommandOutputDocument implements Documentable {
 66 |     protected $command;
 67 |     public function __construct($command) {
 68 |         $this->command = $command;
 69 |     }
 70 |     public function getId() {
 71 |         return $this->command; 
 72 |     }
 73 |     public function getContent() {
 74 |         return shell_exec($this->command); 
 75 |     }
 76 | }
 77 | 
 78 | $documentStore = new DocumentStore();
 79 | // Add HTML document
 80 | $htmlDoc = new HtmlDocument('https://php.net'); 
 81 | $documentStore->addDocument($htmlDoc);
 82 | // Add stream document
 83 | $streamDoc = new StreamDocument(fopen('stream.txt', 'rb')); 
 84 | $documentStore->addDocument($streamDoc);
 85 | 
 86 | 
 87 | // Add terminal command document
 88 | $cmdDoc = new CommandOutputDocument('cat /etc/hosts'); 
 89 | $documentStore->addDocument($cmdDoc);
 90 | print_r($documentStore->getDocuments());
 91 | ```
 92 | 
 93 | 5.4 新加入了 Traits特性，它既不是接口也不是类。主要是为了解决单继承语言的限制。与 Ruby 的 `composable modules` 或 `mixins` 类似。
 94 | 
 95 | 它能被加入到一个或多个已经存在的类中。它声明了类能做什么（表明了其接口特性），同时也包含了具体实现（表明了其类特性）
 96 | 
 97 | Example:
 98 | 
 99 | ```php
100 | <?php
101 | trait Geocodable {
102 |     /** @var string */
103 |     protected $address;
104 |     /** @var \Geocoder\Geocoder */
105 |     protected $geocoder;
106 |     /** @var \Geocoder\Result\Geocoded */
107 |     protected $geocoderResult;
108 |     public function setGeocoder(\Geocoder\GeocoderInterface $geocoder) {
109 |         $this->geocoder = $geocoder;
110 |     }
111 |     public function setAddress($address) {
112 |         $this->address = $address;
113 |     }
114 |     public function getLatitude(){
115 |         if (isset($this->geocoderResult) === false) {
116 |             $this->geocodeAddress();
117 |         }
118 |         return $this->geocoderResult->getLatitude(); 
119 |     }
120 |     public function getLongitude() {
121 |         if (isset($this->geocoderResult) === false) { 
122 |             $this->geocodeAddress();
123 |         }
124 |         return $this->geocoderResult->getLongitude(); 
125 |     }
126 |     protected function geocodeAddress() {
127 |         $this->geocoderResult = $this->geocoder->geocode($this->address); 
128 |         return true;
129 |     } 
130 | }
131 | ```
132 | 
133 | ```php
134 | <?php
135 | class RetailStore {
136 |     use Geocodable;
137 |     // Class implementation goes here
138 |     // Now each RetailStore instance can use the properties and methods provided by the Geocodable trait
139 | }
140 | ```
141 | 
142 | ```php
143 | $geocoderAdapter = new \Geocoder\HttpAdapter\CurlHttpAdapter(); 
144 | $geocoderProvider = new \Geocoder\Provider\GoogleMapsProvider($geocoderAdapter); 
145 | $geocoder = new \Geocoder\Geocoder($geocoderProvider);
146 | $store = new RetailStore();
147 | $store->setAddress('420 9th Avenue, New York, NY 10001 USA'); 
148 | $store->setGeocoder($geocoder);
149 | $latitude = $store->getLatitude(); 
150 | $longitude = $store->getLongitude(); 
151 | echo $latitude, ':', $longitude;
152 | ```
153 | 
154 | PHP解释器将在编译时期将 Traits 的代码拷贝到类中。
155 | 
156 | 从基类继承的成员被 traits 插入的成员所覆盖。
157 | 
158 | 优先顺序是来自当前类的成员方法覆盖了 trait 的方法，而 trait 的方法则覆盖了被继承的方法。
159 | 
160 | 如果两个 trait 都插入了一个同名的方法，如果没有明确解决冲突将会产生一个致命错误。
161 | 
162 | 为了解决多个 trait 在同一个类中的命名冲突，可以使用 insteadof 操作符来明确指定使用冲突方法中的哪一个。
163 | 
164 | 或者使用 as 操作符可以将其中一个冲突的方法以另一个名称来引入。
165 | 
166 | ```
167 | <?php
168 | trait A {
169 |     public function smallTalk() {
170 |         echo 'a';
171 |     }
172 |     public function bigTalk() {
173 |         echo 'A';
174 |     }
175 | }
176 | 
177 | trait B {
178 |     public function smallTalk() {
179 |         echo 'b';
180 |     }
181 |     public function bigTalk() {
182 |         echo 'B';
183 |     }
184 | }
185 | 
186 | class Talker {
187 |     use A, B {
188 |         B::smallTalk insteadof A;
189 |         A::bigTalk insteadof B;
190 |     }
191 | }
192 | 
193 | class Aliased_Talker {
194 |     use A, B {
195 |         B::smallTalk insteadof A;
196 |         A::bigTalk insteadof B;
197 |         B::bigTalk as talk;
198 |     }
199 | }
200 | ?>
201 | ```
202 | 
203 | 使用 as 语法还可以用来调整方法的访问控制权限。
204 | 
205 | ```php
206 | <?php
207 | trait HelloWorld {
208 |     public function sayHello() {
209 |         echo 'Hello World!';
210 |     }
211 | }
212 | 
213 | // 修改 sayHello 的访问控制
214 | class MyClass1 {
215 |     use HelloWorld { sayHello as protected; }
216 | }
217 | 
218 | // 给方法一个改变了访问控制的别名
219 | // 原版 sayHello 的访问控制则没有发生变化
220 | class MyClass2 {
221 |     use HelloWorld { sayHello as private myPrivateHello; }
222 | }
223 | ?>
224 | ```
225 | 


--------------------------------------------------------------------------------
/3.Generators.md:
--------------------------------------------------------------------------------
 1 | php 5.5之后引入了 generators。
 2 | 
 3 | 与 php传统的迭代器不同，generators不仅不需要你实现繁重的迭代器接口，而且还能按需求值，提高性能，特别是在数据量大的时候。
 4 | 
 5 | generators 也并非灵丹妙药。除非你调用，否则它并不知道下一次迭代的值。并且整体只能迭代一次（需要重新迭代则必须重建generators）。
 6 | 
 7 | Example:
 8 | 
 9 | ```php
10 | <?php
11 | function myGenerator() {
12 |     yield 'value1'; 
13 |     yield 'value2'; 
14 |     yield 'value3';
15 | }
16 | ```
17 | 
18 | 调用该迭代器函数，php将返回一个与之关联的对象（建立了generators）。
19 | 
20 | 该对象可被foreach之类的函数迭代，每次迭代 generators 将提供一个具体的值（停留在下一个 yield 之前）。
21 | 
22 | ```php
23 | <?php
24 | foreach (myGenerator() as $yieldedValue) {
25 |     echo $yieldedValue, PHP_EOL; 
26 | }
27 | 
28 | // This outputs:
29 | //    value1
30 | //    value2
31 | //    value3
32 | ```
33 | 
34 | 之前迭代器的解决方案：
35 | 
36 | ```php
37 | <?php
38 | function makeRange($length) {
39 |     $dataset = [];
40 |     for ($i = 0; $i < $length; $i++) {
41 |         $dataset[] = $i;
42 |     }
43 |     return $dataset; 
44 | }
45 | $customRange = makeRange(1000000); 
46 | foreach ($customRange as $i) {
47 |     echo $i, PHP_EOL; 
48 | }
49 | ```
50 | 
51 | generators 的解决方案：
52 | 
53 | ```php
54 | <?php
55 | function makeRange($length) {
56 |     for ($i = 0; $i < $length; $i++) { 
57 |         yield $i;
58 |     } 
59 | }
60 | foreach (makeRange(1000000) as $i) { 
61 |     echo $i, PHP_EOL;
62 | }
63 | ```
64 | 


--------------------------------------------------------------------------------
/4.Closures.md:
--------------------------------------------------------------------------------
 1 | 闭包与匿名函数在 php 5.3 之后被引入。
 2 | 
 3 | 闭包指的是一种函数保留外部变量（创建该函数时外部变量的值）的技术。一般作为回调函数使用。
 4 | 
 5 | Example:
 6 | 
 7 | ```php
 8 | <?php
 9 | $message = 'hello';
10 | 
11 | $example = function () {
12 |     var_dump($message); // NULL
13 | };
14 | echo $example();
15 | 
16 | $example = function () use ($message) {
17 |     var_dump($message); // hello
18 | };
19 | echo $example();
20 | 
21 | // Inherited variable's value is from when the function
22 | // is defined, not when called
23 | $message = 'world';
24 | echo $example(); // also hello
25 | 
26 | // Reset message
27 | $message = 'hello';
28 | 
29 | // Inherit by-reference
30 | $example = function () use (&$message) {
31 |     var_dump($message);
32 | };
33 | echo $example();
34 | 
35 | // The changed value in the parent scope
36 | // is reflected inside the function call
37 | $message = 'world';
38 | echo $example(); // world
39 | 
40 | // Closures can also accept regular arguments
41 | $example = function ($arg) use ($message) {
42 |     var_dump($arg . ' ' . $message);
43 | };
44 | $example("hello"); // "hello world"
45 | ?>
46 | ```
47 | 
48 | 闭包和匿名函数（其实就是没定义名字的函数）是不同的东西，但在PHP里他们是一样的。
49 | 
50 | 匿名函数赋值给变量后，创建了closure对象(每个闭包都是一个 closure 对象实例)，
51 | 
52 | 其实现了 invoke 魔术方法，所以可以通过直接调用变量名来调用该匿名函数。
53 | 
54 | [js与php闭包对比](http://stackoverflow.com/questions/7417430/javascript-closures-vs-php-closures-whats-the-difference)
55 | 
56 | 


--------------------------------------------------------------------------------
/5.ZendOpcache.md:
--------------------------------------------------------------------------------
1 | opcache 是 php 5.5之后第一个内建的字节码内存缓存工具。类似之前的 APC，eAccelerator...
2 | 
3 | opcache 的加速原理是把编译后的 bytecode 存储在内存里面, 避免重复编译 PHP 所造成的资源浪费。
4 | 
5 | 安装 & 配置部分省略。。。。。。
6 | 
7 | [一个关于Opcache的小分享](http://www.laruence.com/2013/11/11/2928.html)
8 | 


--------------------------------------------------------------------------------
/6.Built-in-server.md:
--------------------------------------------------------------------------------
 1 | php 5.4之后引入了内建的http服务器。
 2 | 
 3 | 使用方式：
 4 | 
 5 | ```php
 6 | # 在命令行界面切换到你的项目目录，在此启动该目录将作为服务器的根目录。
 7 | # php -S localhost:4000
 8 | # 在 localhost 上绑定 4000 端口
 9 | # 也可用 0.0.0.0 监听任意ip
10 | # 带自定义配置项的启动 php -S localhsot:8000 -c app/config/php.ini
11 | ```
12 | 
13 | 内建的服务器并不支持 `.htaccess`。php使用 router scripts 来解决这一问题。
14 | 
15 | ```php
16 | php -S localhost:8000 router.php
17 | ```
18 | 
19 | 该脚本将在每一次请求前调用。如果脚本return false，与请求相匹配的静态文件将返回，否则将返回router.php返回的内容。
20 | 
21 | 检测内建服务器的方式：
22 | 
23 | ```php
24 | <?php
25 | if (php_sapi_name() === 'cli-server') {
26 |     // PHP web server
27 | }else{
28 |     // Other web server
29 | }
30 | ```
31 | 
32 | 缺点：
33 | 
34 | 1.只能同时处理一个请求。
35 | 2.mimetypes有限。
36 | 3.router script的rewrite规则是有限的。
37 | 
38 | 总之就是不能用在生产环境啦
39 | 


--------------------------------------------------------------------------------
/7.FIG_and_PSR.md:
--------------------------------------------------------------------------------
1 | PSR 是 PHP互操作性框架制定小组（PHP-FIG :PHP Framework Interoperability Group）制定的PHP编码规范（PSR:Proposing a Standards Recommendation）。
2 | 
3 | 具体内容就不列了，网上中英文都有
4 | 
5 | [PSR](http://www.php-fig.org/)
6 | 
7 | [中文版](https://github.com/PizzaLiu/PHP-FIG)
8 | 
9 | 


--------------------------------------------------------------------------------
/8.Components.md:
--------------------------------------------------------------------------------
 1 | 这部分主要介绍了 Packagist，Composer。
 2 | 
 3 | 几乎每种语言都有包管理器。Java有Maven，Python有easy_install，Ruby有gem，Nodejs有npm。
 4 | 
 5 | PHP在 packagist 之前也有 PEAR，只是没那么好用。
 6 | 
 7 | Composer是PHP中的一个依赖管理工具，它可以让你声明自己项目所依赖的库，然后它将会在项目中为你安装这些库。
 8 | 
 9 | 因为众所周知的原因，请使用 Packagist 的众多国内镜像来保证可用性与速度。
10 | 
11 | [packagist](https://packagist.org/)
12 | 
13 | [Composer](https://getcomposer.org/)
14 | 
15 | [中文文档](http://docs.phpcomposer.com/)
16 | 
17 | [使用GitHub、Composer、Packagist管理公开的PHP包](http://rivsen.github.io/post/how-to-publish-package-to-packagist-using-github-and-composer-step-by-step/)
18 | 
19 | 


--------------------------------------------------------------------------------
/9.BestPractices.md:
--------------------------------------------------------------------------------
  1 | # 过滤，验证与转义
  2 | 
  3 | 任何用户数据都是不可信的。获取用户信息主要是以下几个来源
  4 | 
  5 | * `$_GET`
  6 | * `$_POST`
  7 | * `$_REQUEST`
  8 | * `$_COOKIE`
  9 | * `$argv`
 10 | * `php://stdin`
 11 | * `php://input`
 12 | * `file_get_contents()`
 13 | * `Remote databases`
 14 | * `Remote APIs`
 15 | * `Data from your clients`
 16 | 
 17 | ## 过滤
 18 | 
 19 | ### HTML
 20 | 
 21 | `htmlentities` 函数默认不转义引号与检测字符集，正确的用法应该是
 22 | 
 23 | ```php
 24 | <?php
 25 | $input = '<p><script>alert("You won the Nigerian lottery!");</script></p>'; 
 26 | echo htmlentities($input, ENT_QUOTES, 'UTF-8');
 27 | ```
 28 | 
 29 | 过滤html输入，[HTML Purifier](http://htmlpurifier.org/) 是更好的选择。
 30 | 
 31 | 一些php模版引擎也会自动完成过滤工作，如 [Twig](http://twig.sensiolabs.org/) , [Blade](http://daylerees.com/codebright/blade) 。
 32 | 
 33 | 不要自己写正则来过滤，正则又复杂又慢，html输入不一定是规范的，这一方法有很大的安全隐患。
 34 | 
 35 | ### SQL
 36 | 
 37 | 举一个例子
 38 | 
 39 | ```php
 40 | $sql = sprintf(
 41 |     'UPDATE users SET password = "%s" WHERE id = %s',
 42 |     $_POST['password'],
 43 |     $_GET['id']
 44 | );
 45 | ```
 46 | 
 47 | 直接使用字符串拼接作为sql语句简直就是灾难，直接一个伪造请求就能改掉用户密码。
 48 | 
 49 | ```php
 50 | # POST /user?id=1 HTTP/1.1
 51 | #    Content-Length: 17
 52 | #    Content-Type: application/x-www-form-urlencoded
 53 | #    password=abc";--
 54 | ```
 55 | 
 56 | PS：大部分数据库将 `--` 当作注释而忽略掉后面的内容。
 57 | 
 58 | 更好的方式是使用 [PDO](http://php.net/manual/en/book.pdo.php)
 59 | 
 60 | ### 杂项
 61 | 
 62 | 过滤Email
 63 | 
 64 | ```php
 65 | <?php
 66 | $email = 'john@example.com';
 67 | $emailSafe = filter_var($email, FILTER_SANITIZE_EMAIL);
 68 | ```
 69 | 
 70 | 移除 ASCII 32 之前的字符并转义 127 之后的
 71 | 
 72 | ```php
 73 | <?php
 74 | $string = "\nIñtërnâtiônàlizætiøn\t"; $safeString = filter_var(
 75 |     $string,
 76 |     FILTER_SANITIZE_STRING,
 77 |     FILTER_FLAG_STRIP_LOW|FILTER_FLAG_ENCODE_HIGH
 78 | );
 79 | ```
 80 | 
 81 | [查看更多filter_var用法](http://php.net/ manual/function.filter-var.php)
 82 | 
 83 | ## 验证
 84 | 
 85 | 与过滤不同，验证数据并不改变数据本身，只是检查数据是否符合你的期望。
 86 | 
 87 | 可以使用 `filter_var` 配合 `FIL TER_VALIDATE_*` 标志位来验证数据。
 88 | 
 89 | ```php
 90 | <?php
 91 | $input = 'john@example.com';
 92 | $isEmail = filter_var($input, FILTER_VALIDATE_EMAIL); 
 93 | if ($isEmail !== false) {
 94 |     echo "Success"; 
 95 | }else{
 96 |     echo "Fail"; 
 97 | }
 98 | ```
 99 | 
100 | 以下是其他推荐的验证组件。
101 | 
102 | [aura/filter](https://packagist.org/packages/aura/filter)
103 | 
104 | [respect/validation](https://packagist.org/packages/respect/validation)
105 | 
106 | [symfony/validator](https://packagist.org/packages/symfony/validator)
107 | 
108 | # 密码安全
109 | 
110 | * 绝不明文存储
111 | * 不通过邮件发送密码（一旦发送表示网站明文存储并且能读取用户密码），使用带有效时间并且需要验证的token附带在url中发送来代替发送密码。
112 | * 使用 bcrypt 加密密码
113 | * 尽可能使用 Password Hashing API(若无法使用 php 5.5 以上，可以使用 [password-compat](https://packagist.org/packages/ircmaxell/password-compat) )
114 | 
115 | ## 用户注册流程
116 | 
117 | 请求：
118 | 
119 | ```php
120 | # POST /register.php HTTP/1.1
121 | # Content-Length: 43
122 | # Content-Type: application/x-www-form-urlencoded
123 | # email=john@example.com&password=sekritshhh!
124 | ```
125 | 
126 | ```php
127 | <?php
128 | try{
129 |     // Validate email
130 |     $email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
131 |     if (!$email) {
132 |         throw new Exception('Invalid email');
133 |     } 
134 | 
135 |     // Validate password
136 |     $password = filter_input(INPUT_POST, 'password');
137 |     if (!$password || mb_strlen($password) < 8) {
138 |         throw new Exception('Password must contain 8+ characters');
139 |     }
140 | 
141 |     // Create password hash
142 |     $passwordHash = password_hash(
143 |        $password,
144 |        PASSWORD_DEFAULT,
145 |        ['cost' => 12]
146 |     );
147 | 
148 |     if ($passwordHash === false) {
149 |         throw new Exception('Password hash failed');
150 |     }
151 | 
152 |     // Create user account (THIS IS PSUEDO-CODE)
153 |     $user = new User();
154 |     $user->email = $email;
155 |     $user->password_hash = $passwordHash;
156 |     $user->save();
157 | 
158 |     // Redirect to login page
159 |     header('HTTP/1.1 302 Redirect');
160 |     header('Location: /login.php');
161 | 
162 | } catch (Exception $e) {
163 |     // Report error
164 |     header('HTTP/1.1 400 Bad request');
165 |     echo $e->getMessage();
166 | }
167 | ```
168 | 
169 | 密码字段推荐 `varchar(255)`
170 | 
171 | ## 用户登陆流程
172 | 
173 | 请求：
174 | 
175 | ```php
176 | # POST /login.php HTTP/1.1
177 | # Content-Length: 43
178 | # Content-Type: application/x-www-form-urlencoded
179 | # email=john@example.com&password=sekritshhh!
180 | ```
181 | 
182 | ```php
183 | <?php
184 | session_start(); 
185 | 
186 | try{
187 |     // Get email address from request body
188 |     $email = filter_input(INPUT_POST, 'email');
189 | 
190 |     // Get password from request body
191 |     $password = filter_input(INPUT_POST, 'password');
192 | 
193 |     // Find account with email address (THIS IS PSUEDO-CODE)
194 |     $user = User::findByEmail($email);
195 | 
196 |     // Verify password with account password hash
197 |     if (password_verify($password, $user->password_hash) === false) {
198 |         throw new Exception('Invalid password');
199 |     }
200 | 
201 |     // Re-hash password if necessary(see not below)
202 |     $currentHashAlgorithm = PASSWORD_DEFAULT;
203 |     $currentHashOptions = array('cost' => 15);
204 |     $passwordNeedsRehash = password_needs_rehash(
205 |         $user->password_hash,
206 |         $currentHashAlgorithm,
207 |         $currentHashOptions
208 |     );
209 | 
210 |     if ($passwordNeedsRehash === true) {
211 |         // Save new password hash (THIS IS PSUEDO-CODE)
212 | 
213 |         $user->password_hash = password_hash(
214 |             $password,
215 |             $currentHashAlgorithm,
216 |             $currentHashOptions
217 |         );
218 |         $user->save();
219 |     }
220 | 
221 |     // Save login status to session
222 |     $_SESSION['user_logged_in'] = 'yes';
223 |     $_SESSION['user_email'] = $email;
224 | 
225 |     // Redirect to profile page
226 |     header('HTTP/1.1 302 Redirect');
227 |     header('Location: /user-profile.php');
228 | } catch (Exception $e) {
229 |     header('HTTP/1.1 401 Unauthorized');
230 |     echo $e->getMessage();
231 | }
232 | ```
233 | 
234 | # 时间处理
235 | 
236 | php 5.2 之后推荐使用 `DateTime`,`DateInterval`,`DateTimeZone`来处理时间相关的操作。
237 | 
238 | 第一步，设置时区。两种方式
239 | 
240 | ```php
241 | # declare the default time zone in the php.ini file like this:date.timezone = 'America/New_York';
242 | date_default_timezone_set('America/New_York');
243 | ```
244 | 
245 | 第二步，实例化
246 | 
247 | ```php
248 | # $datetime = new DateTime(); 
249 | # Without arguments, the DateTime class constructor creates an instance that repre‐ sents the current date and time.
250 | $datetime = new DateTime('2014-04-27 5:03 AM');
251 | ```
252 | 
253 | 时间的来源格式不尽相同，使用 `DateTime::createFromFormat()` 静态方法来格式化并创建实例
254 | 
255 | ```php
256 | $datetime = DateTime::createFromFormat('M j, Y H:i:s', 'Jan 2, 2014 23:04:12');
257 | # strtotime ('Jan 2, 2014 23:04:12');
258 | ```
259 | 
260 | 使用 `DateInterval` ，`DatePeriod` 来处理时间间隔。
261 | 
262 | * Y (years)
263 | * M (months)
264 | * D (days)
265 | * W (weeks)
266 | * H (hours)
267 | * M (minutes) 
268 | * S (seconds)
269 | 
270 | 举例，P2D 表示两天。P2DT5H2M 两天五小时两分钟。
271 | 
272 | ```php
273 | <?php
274 | // Create DateTime instance
275 | $datetime = new DateTime('2014-01-01 14:00:00');
276 | // Create two weeks interval
277 | $interval = new DateInterval('P2W');
278 | // Modify DateTime instance
279 | $datetime->add($interval);
280 | echo $datetime->format('Y-m-d H:i:s');
281 | ```
282 | 
283 | ```php
284 | $dateStart = new \DateTime();
285 | $dateInterval = \DateInterval::createFromDateString('-1 day'); 
286 | $datePeriod = new \DatePeriod($dateStart, $dateInterval, 3); 
287 | foreach ($datePeriod as $date) {
288 |     echo $date->format('Y-m-d'), PHP_EOL; 
289 | }
290 | # This outputs:
291 | #     2014-12-08
292 | #     2014-12-07
293 | #     2014-12-06
294 | #     2014-12-05
295 | ```
296 | 
297 | ```php
298 | <?php
299 | $start = new DateTime();
300 | $interval = new DateInterval('P2W');
301 | $period = new DatePeriod($start, $interval, 3);
302 | foreach ($period as $nextDateTime) {
303 |     echo $nextDateTime->format('Y-m-d H:i:s'), PHP_EOL;
304 | }
305 | ```
306 | 
307 | 第三方组件 [Cabon](https://github.com/briannesbitt/Carbon)
308 | 
309 | 切换不同时区的话，使用 `DateTimeZone`
310 | 
311 | ```php
312 | <?php
313 | $timezone = new DateTimeZone('America/New_York'); 
314 | $datetime = new DateTime('2014-08-20', $timezone);
315 | 
316 | $timezone = new DateTimeZone('America/New_York'); 
317 | $datetime = new \DateTime('2014-08-20', $timezone); 
318 | $datetime->setTimezone(new DateTimeZone('Asia/Hong_Kong'));
319 | ```
320 | 
321 | # 数据库
322 | 
323 | 使用 PDO 来处理数据库操作
324 | 
325 | 通过配置 DSN 使得 PDO 将 php 与数据库连接起来
326 | 
327 | DSN 配置由数据库驱动名开头 (e.g., mysql or sqlite),每种数据库格式不尽相同，但大体都包含以下信息:
328 | 
329 | * Hostname or IP address
330 | * Port number
331 | * Database name
332 | * Character set
333 | 
334 | [DSN格式参考](http://php.net/manual/pdo.drivers.php)
335 | 
336 | ```php
337 | <?php 
338 | try {
339 |     $pdo = new PDO( 'mysql:host=127.0.0.1;dbname=books;port=3306;charset=utf8', 'USERNAME','PASSWORD');
340 | } catch (PDOException $e) {
341 |     // Database connection failed
342 |     echo "Database connection failed";
343 |     exit; 
344 | }
345 | ```
346 | 
347 | 连接信息的隐私性要注意保护，不要加到版本控制里，更别放到公共仓库里。
348 | 
349 | 使用 prepare 语句来绑定查询变量，保证安全性
350 | 
351 | ```php
352 | <?php
353 | $sql = 'SELECT id FROM users WHERE email = :email';
354 | $statement = $pdo->prepare($sql);
355 | $email = filter_input(INPUT_GET, 'email');
356 | $statement->bindValue(':email', $email); // default string type
357 | 
358 | $sql = 'SELECT email FROM users WHERE id = :id';
359 | $statement = $pdo->prepare($sql);
360 | $userId = filter_input(INPUT_GET, 'id');
361 | $statement->bindValue(':id', $userId, PDO::PARAM_INT);
362 | ```
363 | 
364 | * PDO::PARAM_BOOL
365 | * PDO::PARAM_NULL
366 | * PDO::PARAM_INT
367 | * PDO::PARAM_STR (default)
368 |     
369 | [一些PDO预定义常量](http://php.net/manual/en/pdo.constants.php)
370 | 
371 | ## 获取查询结果
372 | 
373 | 通过 execute 执行 SQL 之后，若是非 INSERT，UPDATE或DELETE操作，你还需获取数据库返回的纪录。
374 | 
375 | ```php
376 | <?php
377 | $pdo = new PDO("mysql:host=localhost;dbname=world", 'my_user', 'my_pass');
378 | $pdo->setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, false);
379 | // 缓存结果集到php端将有更多的操作可用，但内存占用也会加大
380 | // 不缓存到php端，则使用连接资源向数据库端每次获取数据，虽然php端内存压力小了，但是会明显加大数据库端的负载。
381 | // 对于同一个连接来说，除非结果集被服务端获取完，否则将无法返回其他查询结果。
382 | 
383 | $uresult = $pdo->query("SELECT Name FROM City");
384 | if ($uresult) {
385 |    while ($row = $uresult->fetch(PDO::FETCH_ASSOC)) {
386 |        echo $row['Name'] . PHP_EOL;
387 |    }
388 | }
389 | ?>
390 | ```
391 | 
392 | [Buffered and Unbuffered queries](http://php.net/manual/zh/mysqlinfo.concepts.buffering.php)
393 | 
394 | [其他的FETCH_STYLE](http://php.net/manual/zh/pdostatement.fetch.php)
395 | 
396 | ```php
397 | <?php
398 | // Build and execute SQL query
399 | $sql = 'SELECT id, email FROM users WHERE email = :email'; 
400 | $statement = $pdo->prepare($sql);
401 | $email = filter_input(INPUT_GET, 'email'); 
402 | $statement->bindValue(':email', $email, PDO::PARAM_INT); $statement->execute();
403 | // Iterate results
404 | $results = $statement->fetchAll(PDO::FETCH_ASSOC); 
405 | // results 已经包含全部结果集
406 | foreach ($results as $result) {
407 |     echo $result['email']; 
408 | }
409 | ```
410 | 
411 | 获取指定列结果集
412 | 
413 | ```php
414 | <?php
415 | // Build and execute SQL query
416 | $sql = 'SELECT id, email FROM users WHERE email = :email'; 
417 | $statement = $pdo->prepare($sql);
418 | $email = filter_input(INPUT_GET, 'email'); 
419 | $statement->bindValue(':email', $email, PDO::PARAM_INT); 
420 | $statement->execute();
421 | // Iterate results
422 | // The query result column order matches the column order specified in the SQL query.
423 | while (($email = $statement->fetchColumn(1)) !== false) { 
424 |     echo $email;
425 | }
426 | ```
427 | 
428 | ## 事务
429 | 
430 | PDO 同样支持事务
431 | 
432 | ```php
433 | <?php
434 | require 'settings.php';
435 | // PDO connection
436 | try {
437 |     $pdo = new PDO(
438 |             sprintf(
439 |                 'mysql:host=%s;dbname=%s;port=%s;charset=%s',
440 |                 $settings['host'],
441 |                 $settings['name'],
442 |                 $settings['port'],
443 |                 $settings['charset']
444 |             ),
445 |             $settings['username'],
446 |             $settings['password']
447 |     );
448 | } catch (PDOException $e) {
449 |     // Database connection failed
450 |     echo "Database connection failed";
451 |     exit; 
452 | }
453 | // Statements
454 | $stmtSubtract = $pdo->prepare('
455 |     UPDATE accounts
456 |     SET amount = amount - :amount
457 |     WHERE name = :name
458 | ');
459 |     $stmtAdd = $pdo->prepare('
460 |     UPDATE accounts
461 |     SET amount = amount + :amount
462 |     WHERE name = :name
463 | ');
464 | // Start transaction
465 | $pdo->beginTransaction();
466 | // Withdraw funds from account 1
467 | $fromAccount = 'Checking';
468 | $withdrawal = 50;
469 | $stmtSubtract->bindParam(':name', $fromAccount);
470 | $stmtSubtract->bindParam(':amount', $withDrawal, PDO::PARAM_INT);
471 | $stmtSubtract->execute();
472 | // Deposit funds into account 2
473 | $toAccount = 'Savings';     
474 | $deposit = 50;
475 | $stmtAdd->bindParam(':name', $toAccount);
476 | $stmtAdd->bindParam(':amount', $deposit, PDO::PARAM_INT);
477 | $stmtAdd->execute();
478 | // Commit transaction
479 | $pdo->commit();
480 | ```
481 | 
482 | # 多字节字符串处理
483 | 
484 | 除英文外的大部分语言都无法仅用一个字节来表示。目前主流使用 UTF-8 编码。
485 | 
486 | 使用 [mbstring](http://php.net/manual/book.mbstring.php) 来处理多字节字符串。
487 | 
488 | 比如说用 mb_strlen 来代替 strlen 统计字符串长度。
489 | 
490 | 使用 `mb_detect_encoding()` 与 `mb_convert_encoding()` 函数来检测和转换字符编码。
491 | 
492 | ## 输出 UTF-8 编码的数据
493 | 
494 | ```php
495 | # set default_charset = "UTF-8"; in php.ini
496 | header('Content-Type: application/json;charset=utf-8');
497 | # or in html page, <meta charset="UTF-8"/>
498 | ```
499 | 
500 | # 流（Streams）
501 | 
502 | 即使 php 4.3 之后就引入了 streams，但可以说这一特性是使用人数最少的特性之一，但它却非常好用。
503 | 
504 | streams 是用来在源与目的之间传输数据的，仅此而已。源可以是文件，进程，网络连接，zip压缩包，标准输入输出等等资源，只要其被 stream wrappers 封装成统一的接口。
505 | 
506 | PS：作者将stream比喻为一端流向另一端的水流，我们可以对水流做任何操作，比如加水，拉闸限水等等。。。
507 | 
508 | 归纳来说所有的 Stream Wrappers 都是实现了
509 | 
510 | * 打开连接
511 | * 读写数据
512 | * 关闭连接
513 | 
514 | 几个动作。
515 | 
516 | 每个 stream 包含了 scheme 和 target，`<scheme>://<target>`
517 | 
518 | ```php
519 | <?php
520 | # Flickr API with HTTP stream wrapper
521 | $json = file_get_contents(
522 |     'http://api.flickr.com/services/feeds/photos_public.gne?format=json'
523 | );
524 | ```
525 | 
526 | 像 `file_get_contents()`, `fopen()`, `fwrite()`, `fclose()` 之类的函数底层都实现了对各种 Stream Wrappers 的支持
527 | 
528 | ```php
529 | <?php
530 | $handle = fopen('/etc/hosts', 'rb'); 
531 | while (feof($handle) !== true) {
532 |     echo fgets($handle);
533 | }
534 | fclose($handle);
535 | ```
536 | 
537 | 自定义 Stream Wrapper
538 | 
539 | [链接1](http://php.net/manual/en/stream.streamwrapper.example-1.php)
540 | [链接2](http://php.net/manual/en/class.streamwrapper.php)
541 | 
542 | ## Stream 上下文
543 | 
544 | ```php
545 | <?php
546 | $requestBody = '{"username":"josh"}'; 
547 | $context = stream_context_create(array(
548 |     'http' => array(
549 |     'method' => 'POST',
550 |     'header' => "Content-Type: application/json;charset=utf-8;\r\n" .
551 |                 "Content-Length: " . mb_strlen($requestBody),
552 |                 'content' => $requestBody
553 |     )
554 | ));
555 | $response = file_get_contents('https://my-api.com/users', false, $context);
556 | ```
557 | 
558 | ## Stream 过滤器
559 | 
560 | ```php
561 | <?php
562 | $handle = fopen('data.txt', 'rb'); 
563 | stream_filter_append($handle, 'string.toupper'); 
564 | while(feof($handle) !== true) {
565 |     echo fgets($handle); // <-- Outputs all uppercase characters 
566 | }
567 | fclose($handle);
568 | ```
569 | 
570 | 自定义过滤器
571 | 
572 | ```php
573 | class DirtyWordsFilter extends php_user_filter {
574 |     /**
575 |      * @param resource $in       Incoming bucket brigade
576 |      * @param resource $out      Outgoing bucket brigade
577 |      * @param int      $consumed Number of bytes consumed
578 |      * @param bool     $closing  Last bucket brigade in stream?
579 |      */
580 |     public function filter($in, $out, &$consumed, $closing) {
581 |         $words = array('grime', 'dirt', 'grease'); $wordData = array();
582 |         foreach ($words as $word) {
583 |             $replacement = array_fill(0, mb_strlen($word), '*');
584 |             $wordData[$word] = implode('', $replacement);
585 |         }
586 |         $bad = array_keys($wordData);
587 |         $good = array_values($wordData);
588 |         // Iterate each bucket from incoming bucket brigade
589 |         while ($bucket = stream_bucket_make_writeable($in)) {
590 |             // Censor dirty words in bucket data
591 |             $bucket->data = str_replace($bad, $good, $bucket->data);
592 |             // Increment total data consumed
593 |             $consumed += $bucket->datalen;
594 |             // Send bucket to downstream brigade
595 |             stream_bucket_append($out, $bucket);
596 |         }
597 |         return PSFS_PASS_ON; 
598 |     }
599 | }
600 | 
601 | stream_filter_register('dirty_words_filter', 'DirtyWordsFilter');
602 | 
603 | $handle = fopen('data.txt', 'rb'); 
604 | stream_filter_append($handle, 'dirty_words_filter'); 
605 | while (feof($handle) !== true) {
606 |     echo fgets($handle); // <-- Outputs censored text 
607 | }
608 | fclose($handle);
609 | ```
610 | 
611 | # 错误与异常
612 | 
613 | 可以使用 `@` 操作符来抑制错误提示，但这个极度不推荐的。正确的做法是用 `TryCatch` 和 `Throw` 处理和抛出异常。
614 | 
615 | ## 异常
616 | 
617 | ```php
618 | <?php
619 | $exception = new Exception('Danger, Will Robinson!', 100);
620 | $code = $exception->getCode(); // 100
621 | $message = $exception->getMessage(); // 'Danger...'
622 | 
623 | throw new Exception('Something went wrong. Time for lunch!'); // un catch
624 | 
625 | try {
626 |     $pdo = new PDO('mysql://host=wrong_host;dbname=wrong_name'); 
627 | } catch (PDOException $e) {
628 |     // Inspect the exception for logging
629 |     $code = $e->getCode();
630 |     $message = $e->getMessage();
631 |     // Display a nice message to the user
632 |     echo 'Something went wrong. Check back soon, please.';
633 |     exit; 
634 | }
635 | 
636 | try {
637 |     throw new Exception('Not a PDO exception');
638 |     $pdo = new PDO('mysql://host=wrong_host;dbname=wrong_name'); 
639 | } catch (PDOException $e) {
640 |     // Handle PDO exception
641 |     echo "Caught PDO exception"; 
642 | } catch (Exception $e) {
643 |     // Handle all other exceptions
644 |     echo "Caught generic exception"; 
645 | } finally {
646 |     // Always do this,since php 5.5
647 |     echo "Always do this"; 
648 | }
649 | 
650 | ```
651 | 
652 | php 内置的异常类
653 | 
654 | [Exception](http://php.net/manual/en/class.exception.php)
655 | 
656 | [ErrorException](http://php.net/manual/en/class.errorexception.php)
657 | 
658 | SPL(php标准库)提供了更多的[异常子类](http://php.net/manual/en/spl.exceptions.php)
659 | 
660 | 或者设置全局的异常处理函数，如下。
661 | 
662 | ```php
663 | <?php
664 | // Register your exception handler set_exception_handler(function (Exception $e) {
665 |     // Handle and log exception
666 | });
667 | // Your code goes here...
668 | // Restore previous exception handler
669 | restore_exception_handler();
670 | ```
671 | 
672 | ## 错误
673 | 
674 | 相关函数主要有 trigger_error 与 [error_reporting](http://php.net/manual/function.error-reporting.php)
675 | 
676 | 四大原则：
677 | 
678 | * 永远打开错误收集机制
679 | * 开发环境打开错误提示
680 | * 生产环境绝不提示错误
681 | * 开发和生产环境都用日志纪录错误
682 | 
683 | 开发环境推荐配置：
684 | 
685 | ```php
686 | ; Display errors
687 |   display_startup_errors = On
688 |   display_errors = On
689 | ; Report all errors
690 |   error_reporting = -1
691 | ; Turn on error logging
692 |   log_errors = On
693 | ```
694 | 
695 | 生产环境推荐配置：
696 | 
697 | ```php
698 | ; DO NOT display errors
699 |   display_startup_errors = Off
700 |   display_errors = Off
701 | ; Report all errors EXCEPT notices
702 |   error_reporting = E_ALL & ~E_NOTICE ; Turn on error logging
703 |   log_errors = On
704 | ```
705 | 
706 | 与异常一样，也可以设置全局处理函数
707 | 
708 | ```php
709 | <?php
710 | set_error_handler(function ($errno, $errstr, $errfile, $errline) {
711 |     if (!(error_reporting() & $errno)) {
712 |         // Error is not specified in the error_reporting // setting, so we ignore it.
713 |         return;
714 |     }
715 |     throw new \ErrorException($errstr, $errno, 0, $errfile, $errline); 
716 | });
717 | ```
718 | 
719 | PS:
720 | 
721 | set_error_handler 并不能处理所有错误。包括 `E_ERROR`, `E_PARSE`, `E_CORE_ERROR`, `E_CORE_WARNING`, `E_COMPILE_ERROR`, `E_COMPILE_WARNING`
722 | 
723 | 这些情况下 `register_shutdown_function` 与 `error_get_last` 是更好的解决方案。
724 | 
725 | 优秀的第三方组件：
726 | 
727 | [错误处理](https://github.com/filp/whoops)
728 | 
729 | [日志纪录](https://github.com/Seldaek/monolog)
730 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Modern-php
 2 | 
 3 | 1.NameSpace
 4 | 
 5 | 2.Interface
 6 | 
 7 | 3.Generators
 8 | 
 9 | 4.Closures
10 | 
11 | 5.ZendOpcache
12 | 
13 | 6.Built-in-server
14 | 
15 | 7.FIG & PSR
16 | 
17 | 8.Components
18 | 
19 | 9.Best Practices
20 | 
21 | 10.Hosting
22 | 
23 | 11.PHP-FPM
24 | 
25 | 12.Tuning-Deploy-Test-HHVM
26 | 
27 | ## follow amazing PHP developers: framework creators, core contributors and frequent conference speakers.
28 | 
29 | [followphpdevs.com](http://followphpdevs.com)
30 | 
31 | ## PHP7 Website
32 | 
33 | [PHP7](http://www.php7.site/book/php7.html)
34 | 


--------------------------------------------------------------------------------
/X.Hosting.md:
--------------------------------------------------------------------------------
 1 | 主要介绍了虚拟空间，VPS，PaaS与新主机的初始化，省略
 2 | 
 3 | VPS:
 4 | 
 5 | [Linode](https://www.linode.com/)
 6 | 
 7 | [DigitalOcean](https://www.digitalocean.com)
 8 | 
 9 | Paas:
10 | 
11 | [AWS](http://aws.amazon.com/elasticbeanstalk/)
12 | 
13 | [GAE](https://cloud.google.com/appengine/docs/php/gettingstarted/introduction)
14 | 
15 | [Heroku](https://devcenter.heroku.com/categories/php)
16 | 
17 | [Azure](http://azure.microsoft.com/en-us/)
18 | 


--------------------------------------------------------------------------------
/XI.PHP-FPM.md:
--------------------------------------------------------------------------------
1 | 介绍了 Nginx 与 PHP-FPM
2 | 
3 | 附带一条 segmentfalut的问答 [搞不清FastCgi与PHP-fpm之间是个什么样的关系](http://segmentfault.com/q/1010000000256516)
4 | 


--------------------------------------------------------------------------------
/XII.Tuning-Deploy-Test-HHVM.md:
--------------------------------------------------------------------------------
  1 | # 调优
  2 | 
  3 | ## php.ini
  4 | 
  5 | ### 内存
  6 | 
  7 | 主要是针对 `memory_limit` 的设置。
  8 | 
  9 | 相关 Q&A
 10 | 
 11 | Q：总共能分配多少内存给PHP ? 
 12 | 
 13 | A：假设一台 2GB 内存的 Linode 主机，除 php 外的其他进程，比如 nginx 或 MySQL 都部署在同一台机子上。配置 512M 给 php 是一个不错的选择。
 14 | 
 15 | Q：平均来说，一个php进程占用多少内存？
 16 | 
 17 | A：命令行使用 `top` ，或者调用php函数 `memory_get_peak_usage()` 来查看内存使用情况。以我的观察，大概一个占 5-20MB左右内存。（个人情况，仅供参考）
 18 | 
 19 | 而且如果正在进行文件上传等操作时，内存占用会持续上升。
 20 | 
 21 | Q：PHP-FPM 开多少进程合适?
 22 | 
 23 | A：以分配 512 MB 内存来说。大概分配 34 个 PHP-FPM 进程（同样个人情况，仅供参考）
 24 | 
 25 | 可以使用 [Apache Bench](https://httpd.apache.org/docs/2.2/programs/ab.html) 或 [seige](http://www.joedog.org/siege-home/) 来进行压力测试
 26 | 
 27 | ### 文件上传
 28 | 
 29 | 需要文件上传吗？如果不需要，直接关掉它提高安全系数。
 30 | 
 31 | ```php
 32 | file_uploads = 1 // Whether or not to allow HTTP file uploads
 33 | upload_max_filesize = 10M
 34 | max_file_uploads = 3
 35 | ```
 36 | 
 37 | ### 脚本最大执行时间
 38 | 
 39 | 建议 `max_execution_time = 5` 或 `set_time_limit()` 函数, 长时间运行的任务请丢给[队列](https://github.com/chrisboulton/php-resque)慢慢消化。
 40 | 
 41 | ```php
 42 | <?php
 43 | exec('echo "create-report.php" | at now');  // The standalone create-report.php script runs in a separate background process;
 44 | echo 'Report pending...';
 45 | ```
 46 | 
 47 | ### 设置session解决方案
 48 | 
 49 | ```php
 50 | session.save_handler = 'memcached'
 51 | session.save_path = '127.0.0.2:11211'
 52 | ```
 53 | 
 54 | ### 输出缓存
 55 | 
 56 | php默认开启了输出缓存（非命令行下）
 57 | 
 58 | ```php
 59 | output_buffering = 4096
 60 | implicit_flush = false
 61 | // This is equivalent to calling the PHP function flush() after each and every call to print or echo and each and every HTML block. false by default
 62 | ```
 63 | 
 64 | 如果更改了 output_buffering ，确保它是4的倍数 (32位系统) 或8的倍数 (64位系统).
 65 | 
 66 | ### Realpath Cache
 67 | 
 68 | php会对文件路径做缓存来避免每次在 include path 中搜索。默认大小为 16k。
 69 | 
 70 | ```php
 71 | realpath_cache_size = 64k
 72 | ```
 73 | 
 74 | # 部署
 75 | 
 76 | [Capistrano](http://capistranorb.com/)
 77 | 
 78 | [Magallanes](http://magephp.com/)
 79 | 
 80 | [Rocketeer](http://rocketeer.autopergamene.eu/#/docs/rocketeer/README)
 81 | 
 82 | [PuPHPet](https://puphpet.com/#deploy-target)
 83 | 
 84 | # 测试
 85 | 
 86 | ## 单元测试
 87 | 
 88 | 单元测试主要针对独立的类，方法和函数，最常用的单元测试套件为 [PHPUnit](https://phpunit.de/) 。
 89 | 
 90 | ## 测试驱动开发（Test-driven development）TDD
 91 | 
 92 | 是极限编程中倡导的程序开发方法，以其倡导先写测试程序，然后编码实现其功能得名。
 93 | 
 94 | 测试驱动开发是戴两顶帽子思考的开发方式：先戴上实现功能的帽子，在测试的辅助下，快速实现其功能；再戴上重构的帽子，在测试的保护下，通过去除冗余的代码，提高代码质量。测试驱动着整个开发过程：首先，驱动代码的设计和功能的实现；其后，驱动代码的再设计和重构。
 95 | 
 96 | 正面评价:
 97 | 
 98 | 可以有效的避免过度设计带来的浪费。但是也有人强调在开发前需要有完整的设计再实施可以有效的避免重构带来的浪费。
 99 | 可以让开发者在开发中拥有更全面的视角。
100 | 
101 | 负面评价:
102 | 
103 | 开发者可能只完成满足了测试的代码，而忽略了对实际需求的实现。有实践者认为用结对编程的方式可以有效的避免这个问题。
104 | 会放慢开发实际代码的速度，特别对于要求开发速度的原型开发造成不利。这里需要考虑开发速度需要包含功能和品质两个方面，单纯的代码速度可能不能完全代表开发速度。
105 | 
106 | 对于GUI,资料库和Web应用而言。构造单元测试比较困难，如果强行构造单元测试，反而给维护带来额外的工作量。有开发者认为这个是由于设计方法，而不是开发方法造成的困难。
107 | 
108 | 使得开发更为关注用例和测试案例，而不是设计本身。目前，对于这个观点有较多的争议。
109 | 
110 | 测试驱动开发会导致单元测试的覆盖度不够，比如可能缺乏边界测试。在实际的操作中，和非测试驱动开发一样，当代码完成以后还是需要补充单元测试，提高测试的覆盖度。
111 | 
112 | ## 行为驱动开发（Behavior-driven development）BDD
113 | 
114 | BDD的重点是通过与利益相关者的讨论取得对预期的软件行为的清醒认识。它通过用自然语言书写非程序员可读的测试用例扩展了测试驱动开发方法。行为驱动开发人员使用混合了领域中统一的语言的母语语言来描述他们的代码的目的。这让开发者得以把精力集中在代码应该怎么写，而不是技术细节上，而且也最大程度的减少了将代码编写者的技术语言与商业客户、用户、利益相关者、项目管理者等的领域语言之间来回翻译的代价。
115 | 
116 | [Behat](http://docs.behat.org/en/v2.5/)
117 | 
118 | [PHPspec](http://www.phpspec.net/en/latest/)
119 | 
120 | # 持续集成
121 | 
122 | [TravisCI](https://travis-ci.org/)
123 | 
124 | # 性能分析 & 调试工具
125 | 
126 | [XDebug](http://xdebug.org/)
127 | 
128 | [Xhprof](http://xhprof.io/)
129 | 
130 | [Z-Ray](http://www.zend.com/en/products/server/z-ray-use-cases)
131 | 
132 | [简化PHP开发—Z-Ray的应用](http://code.csdn.net/news/2821335)
133 | 
134 | [New Relic](https://newrelic.com/)
135 | 
136 | # HHVM and Hack
137 | 
138 | [HHVM 是如何提升 PHP 性能的？](http://wuduoyi.com/note/hhvm/)
139 | 
140 | [Hack Lang](http://blog.jobbole.com/63613/)
141 | 


--------------------------------------------------------------------------------