Add deprecations

Author: laurynas

CHANGELOG.md

@@ -13,7 +13,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - Switched to v3 API which uses updated language detection model
-- ⚠️ `simpleDetect` method renamed to `detectCode`
 - ⚠️ `detect` method result fields are `language` and `score`
-- ⚠️ `detect` method no longer accept arrays - use `detectBatch` instead
-- HTTPS is used by default. Removed secure mode configuration.
+- ⚠️ `simpleDetect` deprecated, use `detectCode` instead
+- ⚠️ `detect` for batch detection is deprecated, use `detectBatch` instead
+
+### Removed
+- Secure mode configuration. HTTPS is always used.

lib/DetectLanguage/DetectLanguage.php

@@ -59,7 +59,8 @@ public static function setApiKey($apiKey)
     public static function detect($text)
     {
         if (is_array($text)) {
-            throw new Error('detect method does not accept arrays, use detectBatch instead');
+            trigger_error('detect method does not accept arrays, use detectBatch instead', E_USER_DEPRECATED);
+            return self::detectBatch($text);
         }
 
         return Client::request('POST', 'detect', array('q' => $text));
@@ -115,4 +116,17 @@ public static function getLanguages()
     {
         return Client::request('GET', 'languages');
     }
+
+    // DEPRECATED METHODS
+
+    /**
+     * @deprecated use self::detectCode instead
+     * @param string $text The text for language detection
+     * @return string|null detected language code
+     */
+    public static function simpleDetect($text)
+    {
+        trigger_error('simpleDetect method is deprecated, use detectCode instead', E_USER_DEPRECATED);
+        return self::detectCode($text);
+    }
 }

tests/DetectLanguage/DetectLanguageTest.php

@@ -38,8 +38,10 @@ public function testDetect()
 
     public function testDetectWithArray()
     {
-        $this->expectException('\DetectLanguage\Error');
         $result = DetectLanguage::detect(array('Hello world'));
+
+        $this->assertEquals('en', $result[0][0]->language,
+            'To detect English language.');
     }
 
     public function testDetectCode()
@@ -50,6 +52,13 @@ public function testDetectCode()
             'To detect English language.');
     }
 
+    public function testSimpleDetect()
+    {
+        $result = DetectLanguage::simpleDetect('Hello world');
+        $this->assertEquals('en', $result,
+            'To detect English language.');
+    }
+
     public function testCurlRequest()
     {
         $this->setRequestEngine('curl');