PHP download

Download the PHP package soez-smile/lullabot-amp without Composer

On this page you can find all versions of the php package soez-smile/lullabot-amp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download soez-smile/lullabot-amp
More information about soez-smile/lullabot-amp
Files in soez-smile/lullabot-amp

Vendor soez-smile
Package lullabot-amp
Short Description A set of useful classes and utilities to convert html to AMP html (See https://www.ampproject.org/)
License Apache-2.0
Homepage https://github.com/Lullabot/amp-library

Keywords mobile drupal amp

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of soez-smile/lullabot-amp

Informations about the package lullabot-amp

AMP PHP Library

An open source PHP library and console utility to convert HTML to AMP HTML and report HTML compliance with the AMP HTML specification.

Deprecated AMP convert ( Using Guzzlehttp - ~5.2 ).

What is the AMP PHP Library?

The AMP PHP Library is an open source and pure PHP Library that:

Works with whole or partial HTML documents (or strings). Specifically, the AMP PHP Library:
- Reports compliance of a whole/partial HTML document with the AMP HTML specification. We implement an AMP HTML validator in pure PHP to report compliance of an arbitrary HTML document / HTML fragment with the AMP HTML standard. This validator is a ported subset of the canonical validator that is implemented in JavaScript
- Specifically, the PHP validator supports tag specification validation, attribute specification validation, CDATA validation, CSS validation, layout validation, template validation and attribute property-value pair validation. It will report tags and attributes that are missing, illegal, mandatory according to spec but not present, unique according to spec but multiply present, having wrong parents or ancestors or children and so forth.
- Note: while the AMP PHP library (already) supports many of the features and capabilities of the canonical validator, it is not intended to achieve parity in every respect with the canonical validator. Even within the features we support (e.g. CSS validation) there may be certain validation issues that we don't flag but the canonical validator does.
- Using the feedback given by the in-house PHP validator, the AMP PHP library tries to "correct" some issues found in the HTML to make it more AMP HTML compliant. This would, for example, involve:
- Removing illegal attributes e.g. style attribute within <body> tag
- Removing all kinds of illegal tags e.g. <script> within <body> tag, a tag with a disallowed ancestor, a duplicate unique tag etc.
- Removing illegal property value pairs e.g. removing minimum-scale=hello from <meta name="viewport" content="width=device-width,minimum-scale=hello">
- Adding or correcting the tags necessary for a minimally valid AMP document:
  - <head>, <body>, meta viewport, meta charset, <style> and <noscript> tags
  - The link rel=canonical tag if you let the library know the canonical path of the document
  - Javascript <script> tags for the various AMP components and generic AMP Javascript <script> tag
  - Boilerplate CSS
- If there are mutually exclusive attributes for a tag, removing all but one of them
- Fixing issues with amp-img tags that have problems like inconsistent units, invalid attributes, missing mandatory attributes, invalid implied or specified layouts.
- Notes:
  - The library does a decent job of removing bad things and in a few cases makes some corrections/additions to the HTML. As the library cannot understand the true intention of the user, a lot the validation problems in the HTML may eventually need to be fixed manually by the human.
  - In general, the library will try to fix validation errors in <head> and if its not successful in doing so, remove those tags from <head>. Within <body> the AMP PHP library is less aggressive and in most cases will not remove the tag from the document if the tag does not validate after it attempts any fixes on it.
  - The library needs to be provided with well formed HTML / HTML5. Please don't give it faulty, incorrect html (e.g. non closed <div> tags etc). The correction it does is related to AMP HTML standard issues only. Use a HTML tidying library if you expect your HTML to be malformed.
- Converts some non-amp elements to their AMP equivalents automatically
- A <img> tag is converted to an <amp-img> tag
- A <iframe> tag is converted to an <amp-iframe> tag
- A <audio> tag is converted to an <amp-audio> tag
- A <video> tag is converted to an <amp-video> tag
- Twitter embed code for tweets is converted to an <amp-twitter> tag.
- Instagram embed code for instagrams is converted to an <amp-instagram> tag.
- Youtube embed code for videos is converted to an <amp-youtube> tag
- Dailymotion embed code for videos is converted to an <amp-dailymotion> tag
- Pinterest embed code for pins is converted to an <amp-pinterest> tag
- Soundcloud embed code for audio music is converted to an <amp-soundcloud> tag
- Vimeo embed code for videos is converted to an <amp-vimeo> tag
- Vine embed code for videos is converted to an <amp-vine> tag
- Facebook iframe and Javascript SDK embed code for posts and videos is converted to an <amp-facebook> tag
- Notes:
  - Some of these embed code conversions may not have the advanced features you may require. File an issue if you need enhancements to the functionality already provided or new embed code conversions
  - Some of the embed codes have an associated <script> tag. These conversions will work even if no <script> tag was added to your HTML document. The AMP library will add the appropriate AMP component <script> tag to the <head> if it is provided a full html document.
  - You may experiment with the command line utility amp-console on the above HTML fragments to see how the converted HTML looks
Provides both a console and programmatic interface with which to call the library. It works like this: the developer first provides some HTML. After processing it, the library returns:
- The AMPized HTML
- A list of validation errors in the HTML provided
- A description of fixes and embed code conversions made to the HTML

Use Cases

Currently the AMP PHP Library is used by the Drupal AMP Module to report issues with user entered, arbitrary HTML (originating from Rich Text Editors) and converting the HTML to AMPized HTML (as much as possible)
The AMP PHP Library command line validator can be used for experimentation and to do HTML to AMP HTML conversion of HTML files. While the canonical validator only validates, our library tries to make corrections too. As noted above, our validator is a subset of the canonical validator but already covers a lot of cases
The AMP PHP Library can be used in any other PHP project to "convert" HTML to AMP HTML and report validation issues. It does not have any non-PHP dependencies and will work in PHP 5.5 and higher. It will also work in recent versions of HHVM.

Setup

The project uses a composer workflow. If you're not familiar with composer then please read up on it before trying to set this up.

Using this in Drupal requires some specific steps. Please refer to the Drupal AMP Module documentation.

For all other scenarios, continue reading.

Setup for command line console

git clone this repo, cd into it and type in $ composer install at the command prompt to get all the dependencies of the library. Now you'll be able to use the command line AMP html converter amp-console (or equivalently amp-console.php

Running phpunit tests

After doing a $ composer install for setting up the command line console, you can run some phpunit tests

Looking at test coverage

To see test coverage data first ensure you have the xdebug extenstion installed in your PHP installation.

Setup for your composer based PHP project

To use this in your composer based PHP project, refer to composer docs here to make changes to your composer.json

Or you can simply do $ composer require lullabot/amp:"^1.0.0" to fetch the library from here and automatically update your composer.json

Advanced

Should you wish to follow the bleeding edge you can do $ composer require lullabot/amp:"dev-master". Note that this will create a .git folder in vendor/lullabot/amp. If you want to avoid that, do $ composer require lullabot/amp:"dev-master" --prefer-dist

Using the command line `amp-console`

Please note that the --help command line option is your friend. Use that when confused!

A few example HTML files are available in the test-html folder for you to test drive so that you can get a flavor of the AMP PHP library.

Note that you need to provide --full-document if you're providing a full html document file for conversion.

Lets see the output of the first example command above. The first few lines is the AMPized HTML provided by our library. The rest of the headings are self explanatory.

Using the library in a composer based PHP project

First, follow the setup steps above if you're using this in a composer based project.

Sample code to get started:

Tips

Its probably not a good idea to run the library on your HTML dynamically on every page view. You should try caching the results of $amp->convertToAmpHtml() once the library has run. If you're using the library from a CMS then you should consider using the caching facilities provided by the CMS.

Caveats and Known issues

We only support UTF-8 string input and output from the library. If you're using ASCII, then you don't need to worry as UTF-8 is a superset of ASCII. If you're using another encoding like Latin-1 (etc.) you'll need to convert to UTF-8 strings before you use this library
If you have <img>s with https urls and they don't have height/width attributes and you are using PHP 5.6 or higher and you have not listed any certificate authorities (cafile) in your php.ini file then the library may have problems converting these to <amp-img>. This is because of http://php.net/manual/en/migration56.openssl.php . That link also has a work around.
If your <amp-pinterest> pins are appearing "chopped off" (after pinterest embed code conversion) try the workaround here

Useful Links

Composer homepage for the AMP PHP Library on Packagist, the PHP package repository
AMP Project Homepage
AMP Project code repository on Github
AMP HTML JavaScript validator subtree on Github within the AMP Project code repository
Technical Specification of AMP HTML in Protocol Buffers ASCII message format. See here for the Schema definition of the technical specification

Useful Links for amp-library developers

Notes on the contents of the src/Spec folder
Notes on the contents of the src/Validate folder

You can ignore these links if you simply plan to use this library and not develop for it

Third-party libraries

Symfony:
- takeit/amp-html-bundle
Drupal:
- Drupal AMP Module

All versions of lullabot-amp with dependencies

PHP Build Version

Package Version

Version 1.1.3 Release 19. Feb 2018
create-project require 0 people choosed require and
0 people choosed create-project.

Download

Download latest version of lullabot-amp from vendor soez-smile

Requires php Version >=5.5.0
querypath/querypath Version >=3.0.4
sebastian/diff Version ~1.2
marc1706/fast-image-size Version 1.*
masterminds/html5 Version ^2.2.0
sabberworm/php-css-parser Version ^8.0.0
guzzlehttp/guzzle Version ~5.2

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package soez-smile/lullabot-amp contains the following files

Loading the files please wait ....