phpcfdi / resources-sat-xml-generator
从 SAT 生成 XSD 和 XSLT
Requires
- php: >=8.3
- ext-json: *
- eclipxe/xmlresourceretriever: ^2.0.1
- symfony/console: ^7.0
- symfony/http-client: ^7.0
Requires (Dev)
- fakerphp/faker: ^1.17
- phpunit/phpunit: ^11.1.3
- symfony/finder: ^7.0
README
PHP 程序,用于从 SAT 的 XSD 和 XSLT 文件生成资源以用于 CFDI。
🇺🇸 该项目的文档是西班牙语,因为这将是目标受众的自然语言。
该项目是为了生成 SAT 的 XSD 和 XSLT 文件的本地可使用副本而创建的。
为了生成本地副本,使用 eclipxe/xmlresourceretriever
,这样下载的文件包含相对引用而不是绝对引用。
使用 phpcfdi/sat-ns-registry 来获取 SAT 提供的所有 XSD 和 XSLT 文件的综合注册,它包含所有版本的 CFDI 的信息以及其多个版本的补充。
这个工具用于在 phpcfdi/resources-sat-xml 存储库中创建共享资源。
安装
使用 composer
composer require phpcfdi/resources-sat-xml-generator
你也可以下载它,安装依赖项并使用它
git clone https://github.com/phpcfdi/resources-sat-xml-generator resources-sat-xml-generator
cd resources-sat-xml-generator
composer install
php bin/resources-sat-xml-generator fetch:sat xml-resources/ all
基本用法
php bin/resources-sat-xml-generator fetch http://...
使用 docker
使用
在存储库中找到构建 docker 镜像 的文件,以便执行 容器。
构建名为 resources-sat-xml-generator
的镜像
git clone https://github.com/phpcfdi/resources-sat-xml-generator.git docker build resources-sat-xml-generator -t resources-sat-xml-generator
为了在 /tmp/output
中生成文件并执行镜像,文件将属于执行命令的用户
docker run -it --rm --volume /tmp/output:/tmp/output --user="$(id -u):$(id -g)" \
resources-sat-xml-generator fetch:sat /tmp/output
已知问题
支持
你可以通过在 Github 上打开一个工单来获得支持。
此外,这个库属于 PhpCfdi 社区,因此你可以使用相同的通信渠道来获得社区成员的帮助。
兼容性
这个库将保持与最新的具有 PHP 支持版本 的兼容性。
我们还使用了 语义版本 2.0.0,因此你可以使用这个库而不用担心破坏你的应用程序。
关于此项目
此资源是在 PhpCfdi 的倡议下创建的,目的是拥有 SAT 的公共信息,但以去中心化的方式,具有版本控制和以开放格式可用,以便在计算机系统中使用。
尽管这些资源与某种技术格式相关联,但它们与特定的编程语言或库无关。任何项目,无论是私有还是公共的,无论使用哪种编程语言、架构或技术,只要能够使用存储格式,都应该能够使用这些资源。
贡献
欢迎贡献。请阅读CONTRIBUTING获取更多细节,并记得检查待办事项文件TODO以及变更日志文件CHANGELOG。
版权和许可证
《phpcfdi/resources-sat-xml-generator》库版权© PhpCfdi,许可使用MIT许可证(MIT)。更多信息请见LICENSE。