Merge branch 'master' into file-callback

Author: weakish

.pullapprove.yml

@@ -1,20 +1,23 @@
 language: php
 
 php:
-  - 5.4
-  - 5.5
-  - 7.0
+    - 5.6
+    - 7.0
+    - 7.1
+    - 7.2
+    - 7.3
+    - 7.4
 
 env:
-  - LC_API_REGION=US LC_APP_ID=wnDg0lPt0wcYGJSiHRwHBhD4 LC_APP_KEY=u9ekx9HFSFFBErWwyWHFmPDy LC_APP_HOST=127.0.0.1 LC_APP_PORT=8081
+    - LEANCLOUD_API_SERVER="https://us.avoscloud.com" LEANCLOUD_APP_ID=wnDg0lPt0wcYGJSiHRwHBhD4 LEANCLOUD_APP_KEY=u9ekx9HFSFFBErWwyWHFmPDy LEANCLOUD_REGION=US LEANCLOUD_APP_HOST="127.0.0.1" LEANCLOUD_APP_PORT=8081 LEANCLOUD_WILDCARD_DOMAIN="lncldglobal.com"
+
+install:
+    - composer install
 
 script:
-  - "make test_engine &"
-  - phpunit --coverage-clover=coverage.xml test
+    - "make test_engine &"
+    - "php -r 'exit(PHP_VERSION_ID >= 70200 ? 0 : 1);' || vendor/bin/phpunit test/Php72ObjectDeprecated.php"
+    - "./vendor/bin/phpunit --coverage-clover=coverage.xml test"
 
 after_success:
-  - bash <(curl -s https://codecov.io/bash)
-
-notifications:
-  webhooks: https://hook.bearychat.com/=bw52Y/travis/6e26f4422b2871c20a5b2d40e1d49f73
-
+    - bash <(curl -s https://codecov.io/bash)

.travis.yml

@@ -1,4 +1,90 @@
 
+0.12.0 发布日期：2019-12-30
+----
+
+* 支持平滑推送（`flow_control`）
+* 支持即使通讯服务的 `_rtmClientSign` hook
+* 支持 PHP 7.4
+
+0.11.0 发布日期：2019-10-25
+----
+
+* 支持即时通讯服务新增的 `_clientOnline`、`_clientOffline` 这两个 hook。
+* 支持 PHP 7.3。
+
+0.10.3 发布日期：2019-08-30
+----
+
+* 优化云引擎错误处理
+* 处理中间件中的异常，避免返回 500 内部错误。比如 sessionToken 不合法的异常。
+* 在云引擎错误栈中，打印请求到 API 的 method, url
+
+0.10.2 发布日期：2019-06-24
+----
+
+* 修复 signUpOrLoginByMobilePhone 登录问题
+
+0.10.1 发布日期：2019-06-24
+----
+
+* 修复 signUpOrLoginByMobilePhone 登录问题
+
+0.10.0 发布日期：2019-06-24
+----
+
+- 添加 `User::signUpOrLoginByMobilePhone` 支持手机注册或登录
+
+0.9.0 发布日期：2019-05-23
+----
+
+- 添加 `Cloud::start` 函数，更便捷地初始化云函数服务
+- 添加 `User::logInWithEmail` 函数，支持邮箱密码登录功能
+
+0.8.1 发布日期：2018-09-25
+----
+
+- 修复 `Client::useRegion`
+
+0.8.0 发布日期：2018-06-21
+----
+
+- `Object` 类更名为了 `LeanObject`，兼容 PHP 7.2
+
+当 SDK 运行在 PHP 7.2 以下版本时，会为 `LeanObject` 创建一个别名，继续支持之前使用 `Object` 类的代码，这两个名字实际上指向同一个类，两个类名也可以混用。我们会在 PHP 7.2 以下继续支持 `Object` 一段时间，希望开发者尽快将代码中的 `Object` 改为 `LeanObject`。
+
+0.7.0 发布日期：2018-03-19
+----
+
+* 添加 `Client::setServerUrl` 接口
+* 非云引擎环境下支持 app-router
+
+0.6.0 发布日期：2017-09-06
+----
+
+* 更新 `LEANCLOUD_*` 环境变量
+* 根据环境变量设置是否以生产环境请求
+
+0.5.6 发布日期：2017-04-13
+----
+
+* 修复: 用户定义的 class hook 不需要返回对象，
+    而是由中间件来返回被修改的对象
+
+0.5.5 发布日期：2017-04-12
+----
+
+* 云引擎中输出错误栈
+
+0.5.4 发布日期：2017-02-27
+----
+
+* 修复推送请求中的格式不兼容问题
+
+0.5.3 发布日期：2017-02-13
+----
+
+* 支持小写的 region
+
 0.5.2 发布日期：2017-01-22
 ----
 
@@ -99,4 +185,3 @@ LeanQuery LeanRelation LeanRole LeanUser
 
 0.1.0 发布日期: 2015-10-30
 ----
-

Changelog.md

@@ -1,19 +1,45 @@
-Hacking
-----
+# Hacking
+
+## Pull Request
 
 * Get and install [composer](https://getcomposer.org)
 * Fork the SDK from leancloud/php-sdk
 * Run `composer install` to get dependencies
 * Setup app credential in env variables:
 
-```
-export LC_APP_ID=...
-export LC_APP_KEY=...
-export LC_APP_MASTER_KEY=...
-export LC_API_REGION=US
-```
+    ```sh
+    export LC_APP_ID=...
+    export LC_APP_KEY=...
+    export LC_APP_MASTER_KEY=...
+    export LC_API_REGION=US
+    export LEANCLOUD_APP_HOST="127.0.0.1"
+    export LEANCLOUD_APP_PORT=8081
+    export LEANCLOUD_WILDCARD_DOMAIN="lncldglobal.com"
+    ```
+
+* Run tests:
+
+    ```sh
+    make test_engine &
+    make test
+    ```
 
-* `make test` to run test
-* `make doc` to build documentation
+* `make doc` to build documentation (should running on PHP < 7.2)
+
+* Send a pull request at leancloud/php-sdk
 
 Thanks for your contribution!
+
+## Prepare a Release
+
+Make sure all tests are passed.
+
+Run `make doc` and commit auto generated api doc.
+
+Run `make release V=MAJOR.MINOR.PATCH` (e.g. `make release V=0.11.0`),
+and edit `Changelog.md` (git log subjects are for reference only, do not leave them unchanged).
+
+Commit changes and send a pull request at leancloud/php-sdk.
+
+If everything is O.K., the maintainer will merge the pull request, push a new tag, and publish a new release at GitHub.
+Then a new version will be published at Packagist automatically.

Hacking.md

@@ -1,13 +1,16 @@
 test:
 	vendor/bin/phpunit test
+	php -r 'exit(PHP_VERSION_ID >= 70200 ? 0 : 1);' || vendor/bin/phpunit test/Php72ObjectDeprecated.php
 
 release:
 	./release.sh $V
+	make doc
 
 doc:
-	vendor/bin/apigen generate --source src --destination docs
+	@rm -r docs
+	@php5.6 vendor/bin/apigen generate --source src --destination docs
 
 test_engine:
-	php -S ${LC_APP_HOST}:${LC_APP_PORT} test/engine/index.php
+	php -S ${LEANCLOUD_APP_HOST}:${LEANCLOUD_APP_PORT} test/engine/index.php
 
 .PHONY: test doc test_engine

Makefile

@@ -15,7 +15,7 @@ PHP SDK 提供了对数据存储，用户管理等模块的 PHP 实现及接口
 安装
 ----
 
-运行环境要求 PHP 5.3 及以上版本，以及
+运行环境要求 PHP 5.6 及以上版本，以及
 [cURL](http://php.net/manual/zh/book.curl.php)。
 
 #### composer 安装
@@ -104,10 +104,10 @@ User::logInWith("weibo", array("openid" => "..."));
 #### 对象存储
 
 ```php
-use LeanCloud\Object;
+use LeanCloud\LeanObject;
 use LeanCloud\CloudException;
 
-$obj = new Object("TestObject");
+$obj = new LeanObject("TestObject");
 $obj->set("name", "alice");
 $obj->set("height", 60.0);
 $obj->set("weight", 4.5);
@@ -142,7 +142,7 @@ $obj->destroy();
 我们同样支持子类继承，子类中需要定义静态变量 `$className` ，并注册到存储类:
 
 ```php
-class TestObject extends Object {
+class TestObject extends LeanObject {
     protected static $className = "TestObject";
     public setName($name) {
         $this->set("name", $name);
@@ -235,4 +235,3 @@ try {
 ----
 
 See Hacking.md if you'd like to contribute.
-

README.md

@@ -11,11 +11,13 @@
         }
     ],
     "require": {
+        "php": ">=5.6",
         "ext-curl": "*"
     },
     "require-dev": {
-        "phpunit/phpunit": "^4.8",
-        "apigen/apigen": "^4.1"
+        "phpunit/phpunit": "^5.7",
+        "apigen/apigen": "^4.1",
+        "doctrine/instantiator": "<1.1.0"
     },
     "autoload": {
         "psr-4": {"LeanCloud\\": "src/LeanCloud"}