safran-cassiopee/php-taf-decoder

TAF天气预报解码器

0.2 2021-06-25 13:01 UTC

This package is not auto-updated.

Last update: 2024-09-14 19:58:41 UTC


README

License Build Status Coverage Status Latest Stable Version

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
``