Add setServerUrl close #168 #166 #162

leancloud · Mar 17, 2018 · f5aeeb3 · f5aeeb3
1 parent de96d95
commit f5aeeb3
Show file tree

Hide file tree

Showing 2 changed files with 38 additions and 1 deletion.
diff --git a/src/LeanCloud/Client.php b/src/LeanCloud/Client.php
@@ -62,6 +62,13 @@ class Client {
      */
     private static $appMasterKey;
 
+    /**
+     *  Server url
+     *
+     * @var string
+     */
+    private static $serverUrl;
+
     /**
      * Use master key or not
      *
@@ -194,6 +201,18 @@ public static function useMasterKey($flag) {
         self::$useMasterKey = $flag ? true : false;
     }
 
+    /**
+     * Set server url
+     *
+     * Explicitly set server url with which this client will communicate.
+     * Url shall be in the form of: `https://api.leancloud.cn` .
+     *
+     * @param string $url
+     */
+    public static function setServerUrl($url) {
+        self::$serverUrl = rtrim($url, "/");
+    }
+
     /**
      * Get API Endpoint
      *
@@ -203,7 +222,14 @@ public static function useMasterKey($flag) {
      * @return string
      */
     public static function getAPIEndPoint() {
-        return getenv("LEANCLOUD_API_SERVER") . "/" . self::$apiVersion;
+        if ($url = self::$serverUrl) {
+            return $url . "/" . self::$apiVersion;
+        } else if ($url = getenv("LEANCLOUD_API_SERVER")) {
+            return $url . "/" . self::$apiVersion;
+        } else {
+            throw new \RuntimeException("Server url not set, please set it as:" .
+                                        "`Client::setServerUrl('https://{left-8-chars-of-appid}.api.lncld.net}')`");
+        }
     }
 
     /**

diff --git a/test/ClientTest.php b/test/ClientTest.php
@@ -21,6 +21,17 @@ public function setUp() {
         Client::useMasterKey(false);
     }
 
+    public function testAPIEndPoint() {
+        $url = getenv("LEANCLOUD_API_SERVER");
+        $this->assertEquals("{$url}/1.1", Client::getAPIEndPoint());
+
+        Client::setServerURL("https://hello.api.lncld.net");
+        $this->assertEquals("https://hello.api.lncld.net/1.1", Client::getAPIEndPoint());
+        Client::setServerURL(null);
+
+        $this->assertEquals("{$url}/1.1", Client::getAPIEndPoint());
+    }
+
     public function testVerifyKey() {
         $result = Client::verifyKey(
             getenv("LEANCLOUD_APP_ID"),