facebook/facebook-instant-articles-sdk-extensions-in-php

此包已被废弃,不再维护。没有建议的替代包。

PHP版本的Facebook即时文章SDK扩展,用于将即时文章标记文件转换为AMP

v0.2.1 2018-02-08 18:21 UTC

This package is auto-updated.

Last update: 2020-09-19 20:55:47 UTC


README

Build Status Latest Stable Version

PHP版本的Facebook即时文章SDK扩展提供了一种本地PHP接口,用于将有效的即时文章转换为AMP。这使开发者能够在准备自己的即时文章标记格式后立即拥有AMP内容。

扩展包包括

  • 环境: PHP >= 5.4
  • 依赖关系: 它仅依赖于即时文章SDK及其依赖项,以将即时文章标记格式转换为元素对象树结构。它还依赖于Composer依赖关系管理器。
  • AMP: AMP转换基于AMP项目的当前实现和定义。

快速入门

$ composer require facebook/facebook-instant-articles-sdk-extensions-in-php

安装后,您可以在源代码中包含自动加载脚本

require_once('vendor/autoload.php');

同时,请确保查看快速入门示例

官方文档

您可以在快速入门指南中找到如何使用此SDK的不同组件与您的CMS集成的示例,请参阅文档

贡献

克隆仓库

$ git clone https://github.com/facebook/facebook-instant-articles-sdk-extensions-in-php.git

Composer是测试和开发的前提条件。请全局安装Composer,然后在项目的根目录中运行以下命令安装项目依赖项

$ composer install

运行测试

$ composer test

修复和检查代码风格问题

$ composer cs

如果你很懒?运行

$ composer all

来修复和检查代码风格问题,并运行测试。

如果您更改了结构、路径、命名空间等,请确保运行自动加载生成器

$ composer dump-autoload

为了接受您的贡献,您首先需要签署贡献者许可协议。请参阅CONTRIBUTING以获取详细信息。

故障排除

如果您遇到问题,以下提示可能有助于解决这些问题

  • 如果您遇到图像尺寸/宽高比问题,请检查快速入门示例以获取更多信息。
  • 目前,我们无法确定视频的宽度和高度,您需要通过属性显式传递这些信息,请参阅如何操作 这里

提交问题

  • 请确保您已查阅 问题列表 中是否有类似问题。

  • 告知即将转换的 Instant Article 的规范 URL。

  • 告知来自样式编辑器的 导出 JSON

问题模板

# Issue Data
Instant Article Canonical URL: `http://yourdomain.com/path/article.html`
Exported Style JSON: `{...}`
Page ID: `12345`

# Problem noticed
1. Image XYZ missing

# Expected result
1. The Image XYZ should be present.

许可证

请参阅 许可证文件 获取更多信息。