safran-cassiopee / php-taf-decoder
TAF天气预报解码器
Requires
- php: >=5.3.0
Requires (Dev)
- phpunit/phpunit: 4.3.*
This package is not auto-updated.
Last update: 2024-09-14 19:58:41 UTC
README
PHP TAF解码器
一个用于解码TAF(终端机场预报)字符串的PHP库,已全面单元测试(100%代码覆盖率)
在演示网站上尝试
他们在生产中使用php-taf-decoder
- Safran Cassiopée(私有)
- 在这里提供您的服务?提交一个pull请求或打开一个问题!
简介
这是一个软件库包,提供了解码原始TAF消息的解析器。
TAF是一种为天气预报信息而设计的格式。它主要在航空领域,飞行准备期间使用。原始TAF格式通过国际民用航空组织(ICAO)高度标准化。
要求
此库包仅需要PHP >= 5.3
目前它已自动测试了PHP 5.3、5.4和5.5。
如果您想轻松地将它集成到您的项目中,您应该在您的系统上安装composer。但这不是强制性的。
设置
- 使用composer (推荐)
将以下行添加到您的项目的composer.json
{ "require": { "safran-cassiopee/php-taf-decoder": "dev-master" } }
使用以下命令从项目根目录启动安装
composer install --no-dev
利用composer自动加载来加载库
<?php require_once 'vendor/autoload.php';
- 手动
从github下载最新版本
在您的项目中任何位置解压它。库本身在src目录中,其他目录对库工作不是必须的。
使用静态导入文件加载库
<?php require_once 'path/to/TafDecoder/TafDecoder.inc.php';
用法
实例化解码器并在TAF字符串上运行它。返回的对象是一个DecodedTaf对象,您可以从中检索所有已解码的天气属性。
所有具有单位的值都基于Value
对象,它提供getValue()
和getUnit()
方法。
待办事项:完整地记录DecodedTaf对象的结构
待办事项:提供PHP示例
贡献
如果您发现此库解析不当的有效TAF,请创建一个包含所有可能详细信息的github问题
- 导致问题的完整TAF
- 库返回的解析异常
- 您期望解码器如何表现
- 支持您的建议的内容(链接到官方网站将受到欢迎)
如果您想改进或丰富测试套件,请fork存储库,并通过pull请求提交您的更改。
如果您有任何其他想法来改进库,请使用github问题或直接pull请求,具体取决于您更舒服的方式。
测试和覆盖率
此库已全面单元测试,并使用PHPUnit启动测试。
Travis CI用于持续集成,它会在每次向仓库推送时触发PHP 5.3、5.4、5.5的测试。
要自行运行测试,您必须首先安装开发依赖项(需要composer)
composer install --dev
apt-get install php5-xdebug # only needed if you're interested in code coverage
使用以下命令启动测试套件
./vendor/bin/phpunit tests
您还可以通过添加--coverage-html
选项来生成HTML覆盖率报告
./vendor/bin/phpunit --coverage-html ./report tests
``