tcesarpinho / php-sigep
与快递公司Web Service集成。生成标签,查询价格和期限,打印标签和PLP等。
Requires
- php: >=5.1.0
- tcesarpinho/php-sigep-fpdf: >=0.0.1
This package is not auto-updated.
Last update: 2020-07-30 22:47:46 UTC
README
###正式版本 [https://github.com/stavarengo/php-sigep] ###移除日志类以避免与magento冲突 ###请帮助项目成长。发送代码或项目文档的pull request。
PHP SIGEP - Correios
实施快递公司SIGEP Web Service。
查看在线演示,示例和我们的页面上的文档。
与快递公司Web Service集成。查询价格和期限,打印标签和PLP等。此API可以
- 计算订单的价格和期限。
- 获取订单的追踪数据。
- 检查两个地址之间是否允许某种服务类型(Sedex,PAC等)。
- 生成并发送预寄递单(PLP)的XML到快递公司。
- 生成新的邮标签号码。
- 创建和/或验证标签的校验位(通过Web Service或非Web Service)。
- 以PDF格式生成PLP报告。
- 以PDF格式生成邮标签。
- 以PDF格式生成每种服务类型的戳记(每种服务的标志)。
要求
- PHP >= 5.1.0
- 如果您需要打印标签和报告,请下载FPDF 1.7 www.fpdf.org。
不要忘记在尝试打印报告之前配置FPDF以自动加载。
使用Composer安装(推荐)
- 我们不通过标签控制版本,但master分支只有在代码稳定时才会更新。因此,最新稳定版本始终是master分支。
将以下行添加到您的composer.json
文件中:"stavarengo/php-sigep": "dev-master"
"stavarengo/php-sigep-fpdf": "dev-master"
然后通过命令行执行composer update
。
手动安装
-
我们不通过标签控制版本,但master分支只有在代码稳定时才会更新。因此,最新稳定版本始终是master分支。
-
下载最新版本。
-
要使用php-sigep类,您只需加载"php-sigep/src/PhpSigep/Bootstrap.php"文件。这将注册加载器。
功能
缓存
PhpSigep的缓存组件受到了Zend Framework的缓存组件的启发。
默认情况下,PhpSigep的缓存是禁用的。
此缓存存储了邮政Web服务的某些响应,这些响应可以随后重用。除了提高请求响应速度外,还可以防止用户在邮政服务器不稳定时无法继续操作(相信我:它经常不稳定)。
要启用缓存,在创建PhpSigep配置时使用“cacheOptions”键。例如:php new \PhpSigep\Config( array( 'cacheOptions' => array( 'storageOptions' => array( 'enabled' => true, 'ttl' => 60*60*24*7,// 一周 ), ), ... ), );
在storageOptions
数组中,您可以使用PhpSigep\Cache\Storage\Adapter\AdapterOptions
类中的任何属性名称。
贡献
要运行测试套件,通过命令行执行./vendor/bin/phpunit
。
- 进行Fork
- 为功能创建分支(
git checkout -b nova-funcionalidade
) - 提交您的修改(
git commit -am '添加新功能'
) - 将分支推送到远程(
git push origin nova-funcionalidade
) - 创建一个新的Pull Request