README

帮助项目成长。发送源代码或项目文档的 pull request。

PHP SIGEP - 巴西邮政

在此下载最新稳定版本： https://github.com/stavarengo/php-sigep/tags

巴西邮政 SIGEP Web Service 实现。

查看在线演示、示例和文档在我们的页面.

与巴西邮政的 Web Service 集成。查询价格和期限，打印标签和 PLP 等。此 API 可以

计算订单的价格和送货期限。
获取订单的跟踪数据。
检查两种地址之间是否允许某种服务类型（如 Sedex、PAC 等）。
生成并发送预列表寄递（PLP）的 XML 给巴西邮政。
生成新的寄递标签编号。
创建和/或验证标签校验位的有效性（通过 Web Service 或不通过）。
以 PDF 格式生成 PLP 报告。
以 PDF 格式生成寄递标签。
为每种服务类型（每种服务的标志）生成 PDF 格式的戳记。
在投递后获取 PLP 数据 [由 Sara 处理]

要求

PHP >= 5.4.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" 文件。这将注册 loader。

常见问题

PHP 5.3 的问题

这个问题已在这里报告： stavarengo#35 一些用户在 PHP 版本的问题下遇到了与巴西邮政 WebService 的连接和认证问题。要解决这个问题，您可以或使用更高版本的 PHP（>=5.4）或从您的服务器上下载 Correios 的 WSDL 并使用它进行连接。如果您选择下载 WSDL，请按照以下步骤操作：

将此文件保存在您的本地环境 https://apps.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl
更改您生产环境中的配置，以指向您下载的文件。以下是一个示例。

$config = new \PhpSigep\Config();
$config->setEnv(\PhpSigep\Config::ENV_PRODUCTION);
$config->setWsdlAtendeCliente('CAMINHO-DO-SEU-ARQUIVO-LOCAL');
\PhpSigep\Bootstrap::start($config);

注意：此方法在本地服务器（如 Wamp、Xammp 等）上无法工作。

功能

缓存

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

kspotx / php-sigep

维护者

详细信息