first commit

Author: artisan

.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = false
+
+[*.{vue,js,scss}]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto
+
+/tests export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+.scrutinizer.yml export-ignore
+.travis.yml export-ignore
+phpunit.php export-ignore
+phpunit.xml.dist export-ignore
+phpunit.xml export-ignore
+.php_cs export-ignore

.gitignore

@@ -0,0 +1,7 @@
+*.DS_Store
+/vendor
+/coverage
+sftp-config.json
+composer.lock
+.subsplit
+.php_cs.cache

.php_cs

@@ -0,0 +1,27 @@
+<?php
+$header = <<<EOF
+This file is part of the overtrue/weather.
+
+(c) overtrue <i@overtrue.me>
+
+This source file is subject to the MIT license that is bundled.
+EOF;
+
+return PhpCsFixer\Config::create()
+    ->setRiskyAllowed(true)
+    ->setRules(array(
+        '@Symfony' => true,
+        'header_comment' => array('header' => $header),
+        'array_syntax' => array('syntax' => 'short'),
+        'ordered_imports' => true,
+        'no_useless_else' => true,
+        'no_useless_return' => true,
+        'php_unit_construct' => true,
+        'php_unit_strict' => true,
+    ))
+    ->setFinder(
+        PhpCsFixer\Finder::create()
+            ->exclude('vendor')
+            ->in(__DIR__)
+    )
+;

README.md

@@ -0,0 +1,92 @@
+
+# Weather
+
+基于百度地图接口的 PHP 天气信息组件。
+
+## 安装
+
+```sh
+$ composer require overtrue/weather -vvv
+```
+
+## 配置
+
+在使用本拓展之前，你需要去 [百度地图](http://lbsyun.baidu.com/index.php?title=car/api/weather) 注册账号，然后创建应用，获取应用的 `ak` 值
+
+## 使用
+
+```php
+use Overtrue\Weather\Weather;
+
+$ak = 'xxxxxxxxxxxxxxxxxxxxxxxxxxx';
+
+$weather = new Weather($ak);
+
+// 返回数组格式
+$response = $weather->getWeather('深圳');
+
+// 批量获取
+$response = $weather->getWeather('深圳,北京');
+
+// 返回 XML 格式
+$response = $weather->getWeather('深圳', 'xml');
+
+// 按坐标获取
+$response = $weather->getWeather('116.306411,39.981839', 'json');
+
+// 自定义坐标格式（coord_type）
+$response = $weather->getWeather('116.306411,39.981839', 'json', 'bd09ll');
+```
+
+### 参数说明
+```
+array | string   getWeather(string $location, string $format = 'json', string $coordType = null)
+```
+
+> - $location 地点，中文或者坐标地址，多个用斗角逗号隔开
+> - $format 返回格式， `json`(默认)/`xml`, `json` 将会返回数组格式，`xml` 返回字符串格式。
+> - $coordType 坐标格式，允许的值为`bd09ll`、`bd09mc`、`gcj02`、`wgs84`，默认为 `gcj02` 经纬度坐标。
+> 详情说明请参考官方：http://lbsyun.baidu.com/index.php?title=car/api/weather
+
+### 在 Laravel 中使用
+
+在 Laravel 中使用也是同样的安装方式，配置写在 `config/services.php` 中：
+
+```php
+	 'weather' => [
+        'ak' => env('BAIDU_WEATHER_AK'),
+        'sn' => env('BAIDU_WEATHER_SN'), 
+    ],
+```
+
+然后在 `.env` 中配置（`BAIDU_WEATHER_SN` 为可选）：
+
+```env
+BAIDU_WEATHER_AK=
+BAIDU_WEATHER_SN=
+```
+
+可以用两种方式来获取 `Overtrue\Weather\Weather` 实例：
+
+#### 方法参数注入
+
+```php
+	public function edit(Weather $weather) 
+	{
+			$response = $weather->get('深圳');
+	}
+```
+
+#### 服务名访问
+
+```php
+$response = app('weather')->get('深圳');
+```
+
+## 参考
+
+- [百度地图天气接口](http://lbsyun.baidu.com/index.php?title=car/api/weather)
+
+## License
+
+MIT

composer.json

@@ -0,0 +1,21 @@
+{
+    "name": "overtrue/weather",
+    "description": "A weather SDK.",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "overtrue",
+            "email": "i@overtrue.me"
+        }
+    ],
+    "autoload": {
+        "psr-4": {
+            "Overtrue\\Weather\\": "./src"
+        }
+    },
+    "require": {
+        "guzzlehttp/guzzle": "^6.3",
+        "phpunit/phpunit": "^7.3",
+        "mockery/mockery": "^1.1"
+    }
+}

phpunit.xml.dist

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false">
+    <testsuites>
+        <testsuite name="Application Test Suite">
+            <directory>./tests/</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist>
+            <directory suffix=".php">src/</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/Exceptions/Exception.php

@@ -0,0 +1,18 @@
+<?php
+
+/*
+ * This file is part of the overtrue/weather.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled.
+ */
+
+namespace Overtrue\Weather\Exceptions;
+
+/**
+ * Class Exception.
+ */
+class Exception extends \Exception
+{
+}

src/Exceptions/HttpException.php

@@ -0,0 +1,18 @@
+<?php
+
+/*
+ * This file is part of the overtrue/weather.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled.
+ */
+
+namespace Overtrue\Weather\Exceptions;
+
+/**
+ * Class HttpException.
+ */
+class HttpException extends Exception
+{
+}

src/Exceptions/InvalidArgumentException.php

@@ -0,0 +1,18 @@
+<?php
+
+/*
+ * This file is part of the overtrue/weather.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled.
+ */
+
+namespace Overtrue\Weather\Exceptions;
+
+/**
+ * Class InvalidArgumentException.
+ */
+class InvalidArgumentException extends Exception
+{
+}