Download the PHP package simexis/embed without Composer
On this page you can find all versions of the php package simexis/embed. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download simexis/embed
More information about simexis/embed
Files in simexis/embed
Package embed
Short Description PHP library to retrieve page info using oembed, opengraph, etc
License MIT
Homepage https://github.com/oscarotero/Embed
FAQ
Example:
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 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.
Informations about the package embed
Embed
PHP library to get information from any web page (using oembed, opengraph, twitter-cards, scrapping the html, etc). It's compatible with any web service (youtube, vimeo, flickr, instagram, etc) and has adapters to some sites like (archive.org, github, facebook, etc).
Requirements:
- PHP 5.4+
- Curl library installed
Usage
Customization
You can set some options using an array as second argument. In this array you can configure the adapters, providers, resolvers, etc.
The adapter
The adapter is the class that get all information of the page from the providers and choose the best result for each value. For example, a page can provide multiple titles from opengraph, twitter cards, oembed, the <title> html element, etc, so the adapter get all this titles and choose the best one.
Embed has an generic adapter called "Webpage" to use in any web but has also some specific adapters for sites like archive.org, facebook, google, github, spotify, etc, that provides information using their own apis, or have any other special issue.
You can configure these adapters and even create your own adapter, that must implement the Embed\Adapters\AdapterInterface.
The available options for the adapters are:
- minImageWidth (int): Minimal image width used to choose the main image
- minImageHeight (int): Minimal image height used to choose the main image
- imagesBlacklist (array): Images that you don't want to be used. Could be plain text or Url match pattern.
- getBiggerImage (bool): Choose the bigger image as the main image (instead the first found, that usually is the most relevant).
- getBiggerIcon (bool): The same than getBiggerImage but used to choose the main icon
The providers
The providers get the data from different sources. Each source has it's own provider. For example, there is a provider for open graph, other for twitter cards, for oembed, html, etc. The providers that receive options are:
oembed
Used to get data from oembed api if it's available. It accepts two options:
- parameters (array): Extra query parameters to send with the oembed request
- embedlyKey (string): If it's defined and the page has not its own oembed service, use the embedly api.
html
Used to get data directly from the html code of the page:
- maxImages (int): Max number of images fetched from the html code (searching for the
<img>elements). By default is -1 (no limit). Use 0 to no get images.
facebook:
This provider is used only for facebook pages, to get information from the graph api:
- key (string): the access token used to get info from pages that are not public
soundcloud:
Used only for soundcloud pages, to get information using its api.
- key (string): to get info from soundcloud API.
The request resolver
Embed uses the Embed\RequestResolvers\Curl class to resolve all requests using the curl library. You can set options to the curl request or use your custom resolver creating a class implementing the Embed\RequestResolvers\RequestResolverInterface.
The resolver configuration is defined under the "resolver" key and it has two options:
- class: Your custom class name if you want to use your own implementation
- config: The options passed to the class. If you use the default curl class, the config are the same than the curl_setopt PHP function
Image info
To check the images and get their mimetype and dimmensions, we have the class Embed\ImageInfo\Curl. This class uses curl to make request, get the first bytes to get the image type and dimmensions and close the connection. So the image wont be downloaded entirely, just until the downloaded data is enought to get this information.
Like the resolver class, you can provide your own image class (it must implement the Embed\ImageInfo\ImageInfoInterface) and/or change the configuration. The available options are the same:
- class: Your custom class name if you want to use your own implementation
- config: The options passed to the class. If you use the default curl class, the config are the same than the curl_setopt PHP function
Example
Do you need help?
I can help you in HackHands: https://hackhands.com/oscarotero
Contributors
- https://github.com/oscarotero (creator and maintainer)
- https://github.com/buggedcom
- https://github.com/jasny
