Download the PHP package zhaiyuxin/weather without Composer
On this page you can find all versions of the php package zhaiyuxin/weather. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package weather
Weather - 高德天气 API 组件
一个基于高德开放平台 API 的 PHP 天气信息组件,支持 Laravel 框架,提供简单易用的天气查询功能。
✨ 特性
- 🌤️ 支持实时天气查询
- 🏙️ 支持全国城市天气信息
- 📱 完美集成 Laravel 框架
- 🔧 支持 JSON 和 XML 响应格式
- 🚀 基于 Guzzle HTTP 客户端
- 🧪 完整的测试覆盖
- 📚 详细的文档和示例
📋 系统要求
- PHP >= 8.0
- Laravel >= 10.0
- Composer
🚀 安装
通过 Composer 安装
⚙️ 配置
1. 获取高德开放平台 API Key
首先,你需要在 高德开放平台 注册账号并创建应用,获取 API Key。
2. 环境变量配置
在 .env 文件中添加:
3. 配置文件
配置文件位于 config/services.php:
📖 使用方法
基本用法
1. 直接实例化
2. Laravel 中使用
3. 使用 Facade (Laravel)
API 参数说明
getWeather($city, $type, $format)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
$city |
string | 是 | - | 城市名称或编码 |
$type |
string | 否 | live | 天气类型:live(实况天气) 或 forecast(预报天气) |
$format |
string | 否 | json | 响应格式:json 或 xml |
响应格式
JSON 格式 (默认)
XML 格式
高级配置
自定义 Guzzle 选项
🧪 测试
运行测试套件:
📝 异常处理
组件提供了完善的异常处理机制:
异常类型
InvalidArgumentException: 参数验证失败HttpException: HTTP 请求异常
🔧 开发
克隆项目
运行测试
代码风格检查
🤝 贡献
我们欢迎所有形式的贡献!请查看我们的 贡献指南。
贡献方式
- 🐛 报告 Bug
- 💡 提出新功能建议
- 📝 改进文档
- 🔧 提交代码修复
- ⭐ 给项目点星
开发流程
- Fork 项目
- 创建功能分支 (
git checkout -b feature/xxx) - 提交更改 (
git commit -m 'Add some feature') - 推送到分支 (
git push origin feature/xxx) - 创建 Pull Request
📄 许可证
本项目基于 MIT 许可证 开源。
🙏 致谢
📞 支持
如果你在使用过程中遇到问题,可以通过以下方式获取帮助:
- 📧 邮箱: [email protected]
- 🐛 GitHub Issues
- 📖 GitHub Discussions
- 🐦 Twitter: @zhaiyuxin103
⭐ 支持项目
如果这个项目对你有帮助,请给我们一个 ⭐️!
Made with ❤️ by YuXin Zhai
All versions of weather with dependencies
PHP Build Version
Package Version
Requires
guzzlehttp/guzzle Version
^7.9
The package zhaiyuxin/weather contains the following files
Loading the files please wait ...