【亲测免费】 Embed 项目使用教程

1. 项目的目录结构及介绍

Embed 项目的目录结构如下：

Embed/
├── demo/
│   └── index.php
├── src/
│   ├── Embed/
│   └── ...
├── tests/
│   └── ...
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── composer.json
├── LICENSE
├── phpunit.xml.dist
└── README.md

目录结构介绍

• demo/: 包含项目的演示文件，其中 index.php 是启动文件。
• src/: 包含项目的核心代码，Embed/ 目录下是主要的 PHP 类文件。
• tests/: 包含项目的测试代码。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件配置。
• CHANGELOG.md: 项目更新日志。
• composer.json: Composer 依赖管理文件。
• LICENSE: 项目许可证文件。
• phpunit.xml.dist: PHPUnit 测试配置文件。
• README.md: 项目说明文件。

2. 项目的启动文件介绍

项目的启动文件位于 demo/index.php。该文件用于演示如何使用 Embed 库来获取网页信息。

启动文件内容

<?php
require '../vendor/autoload.php';

use Embed\Embed;

$embed = new Embed();
$info = $embed->get('https://www.youtube.com/watch?v=PP1xn5wHtxE');

echo $info->title;
echo $info->description;
echo $info->url;
echo $info->image;
echo $info->code->html;

启动文件功能

• 引入 Composer 自动加载文件。
• 使用 Embed 类获取指定 URL 的网页信息。
• 输出网页的标题、描述、URL、图片和嵌入代码。

3. 项目的配置文件介绍

项目的配置文件主要是 composer.json，用于管理项目的依赖和自动加载。

composer.json 内容

{
    "name": "embed/embed",
    "description": "PHP library to get information from any web page (using oembed, opengraph, twitter-cards, scrapping the html, etc).",
    "require": {
        "php": ">=7.4",
        "ext-curl": "*",
        "psr/http-message": "^1.0",
        "psr/http-client": "^1.0",
        "psr/http-factory": "^1.0"
    },
    "autoload": {
        "psr-4": {
            "Embed\\": "src/Embed/"
        }
    }
}

配置文件功能

• name: 项目名称。
• description: 项目描述。
• require: 项目依赖的 PHP 版本和扩展。
• autoload: 自动加载配置，指定命名空间和对应目录。

通过以上配置，Composer 可以自动加载项目中的类文件，并管理项目的依赖关系。