update readme.md

Author: xiezefan

README.md

@@ -1,3 +1,9 @@
+# JPush API client library for PHP - README
+
+标签： JPush
+
+---
+
 [![Build Status](https://travis-ci.org/jpush/jpush-api-php-client.svg?branch=master)](https://travis-ci.org/jpush/jpush-api-php-client)
 
 # JPush API client library for PHP
@@ -12,26 +18,54 @@
 PHP >= 5.3
 
 ### 快速安装
-解压 **examples/vendor.tar.gz** 到项目目录，在需要使用JPush的源文件头部 引入 vendor/autoload.php  既可使用。
-```php
-require_once 'vendor/autoload.php';
+JPush PHP Library 使用 Composer管理项目依赖, 鉴于某些原因, 国内的用户使用Composer下载依赖库比较困难,所以我们将Composer依赖打包. 用户可以通过以下方式在您的项目中加入JPush PHP Library.
+
+
+1.下载依赖包 [vendor.tar.gz][3] 
+2.解压 [vendor.tar.gz][4] 到您的项目目录下，在需要使用JPush的源文件头部 引入 `vendor/autoload.php`  既可使用。 
 ```
+# 引入代码
+php require_once 'vendor/autoload.php';
+```
+PS: 在下载的[JPush PHP Library][5]中的[example][6]文件夹有简单示例代码, 开发者可以参考其中的样例快速了解该库的使用方法.
+
+
+
+### 使用 Composer
 
+如果你的项目使用composer管理依赖, 可以通过以下方式使用JPush PHP Library.
 
-### Composer install
 
-Use composer to fetch the library and dependencies defined in `composer.json`, and install them:
+1. 在 `composer.json` 中添加 jpush依赖, 目前最新版本为 v3.2.0
 
 ```
-#download the composer.phar
-$ curl -sS https://getcomposer.org/installer | php
-#install by composer.json
-$ php composer.phar install
+{
+    "require":{
+        "jpush/jpush": "v3.2.0"
+    }
+}
 ```
+2. 执行 `php composer.phar install` 或 `php composer.phar update`
+
 
 
 
 ## 快速使用
+
+### Example
+
+[example][6]文件夹有简单示例代码, 开发者可参考以快速使用该库
+
+├── examples
+│   ├── composer.json　项目依赖
+│   ├── DeviceExample.php 对Tag, Alias, Registeration_id的操作示例
+│   ├── PushExample.php　推送示例
+│   ├── README.md　说明
+│   ├── ReportExample.php　获取统计信息示例
+│   └── ValidateExample.php　使用validate接口示例
+
+
+
 ### Easy Push
 
 ```php
@@ -80,20 +114,41 @@ foreach($result->received_list as  $received) {
 }
 ```
 
+## FAQ
+
+Q: 运行示例提示　`require_once(vendor/autoload.php): failed to open stream` 怎么解决?
+A: 下载下载依赖包 [vendor.tar.gz][3] 并解压到examples目录即可, 也可以使用composer管理依赖, 在composer.json中加入 `"jpush/jpush": "v3.2.0"` 并执行 `php composer.phar install` 即可.
+
+Q: 运行示例提示 
+```
+Fatal error: Uncaught exception 'UnexpectedValueException' with message 'The stream or file "jpush.log" could not be opened: failed to open stream: Permission denied
+```
+该如何解决?
+A: 此问题是因为工程没有写入权限导致不能生成日志文件. 只需对赋予该项目对本目录的写入权限即可,如 `sudo chmod 777 example`
+
+Q: 使用示例每次推送都会打印推送的JSON, 如何禁止其打印?
+A: 在调用示例推送的时候, 注释掉 `->printJSON()` 即可, 该函数可以打印当前构建的推送对象.
+
+
+
 ## 文档
 
-* [JPush Push API v3][4]  
-* [JPush Report API][5]
-* [JPush Api PHP client doc][6]
+* [JPush Push API v3][7]  
+* [JPush Report API][8]
+* [JPush Api PHP client doc][9]
 
 ## 版本更新
 
-[Release页面][7]有详细的版本发布记录与下载。
+[Release页面][10]有详细的版本发布记录与下载。
 
 
   [1]: http://docs.jpush.cn/display/dev/Push-API-v3
   [2]: http://docs.jpush.cn/display/dev/Report-API
-  [4]: http://docs.jpush.cn/display/dev/Push-API-v3
-  [5]: http://docs.jpush.cn/display/dev/Report-API
-  [6]: doc/api.md
-  [7]: https://github.com/jpush/jpush-api-php-client/releases/
+  [3]: http://jpushsdk.qiniudn.com/vendor.tar.gz
+  [4]: http://jpushsdk.qiniudn.com/vendor.tar.gz
+  [5]: http://jpushsdk.qiniudn.com/jpush-api-php-client-v3.2.0.tar.gz
+  [6]: /examples
+  [7]: http://docs.jpush.cn/display/dev/Push-API-v3
+  [8]: http://docs.jpush.cn/display/dev/Report-API
+  [9]: doc/api.md
+  [10]: https://github.com/jpush/jpush-api-php-client/releases/