如何在PHP原生项目（非框架）中集成和使用Composer？（从零开始）-composer-PHP中文网

如何在PHP原生项目（非框架）中集成和使用Composer？（从零开始）

穿越時空

发布： 2025-12-21 09:59:27

原创

589人浏览过

PHP原生项目集成Composer的核心是声明式依赖管理与自动加载，需安装Composer、初始化项目生成composer.json、用composer require安装包并引入vendor/autoload.php，再通过PSR-4配置实现自定义代码自动加载。

如何在php原生项目（非框架）中集成和使用composer？（从零开始）

在PHP原生项目中集成Composer，核心是把依赖管理从“手动下载+require”变成“声明式定义+自动加载”。不需要框架，只要PHP 7.2+ 和能运行命令行，就能用。

1. 安装Composer（本地或全局）

去 composer.org/download 下载安装脚本：
Linux/macOS 执行：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e826a48dd3bf4544671d09985000178721b12') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

登录后复制

然后把生成的 composer.phar 放到系统PATH里（比如 /usr/local/bin/composer），或直接用 php composer.phar 调用。

Windows 用户推荐下载 Composer-Setup.exe，它会自动配置好环境变量。

2. 初始化项目并生成 composer.json

进入你的PHP项目根目录（比如 /var/www/my-site），运行：

立即学习“PHP免费学习笔记（深入）”；

composer init

登录后复制

它会交互式提问：项目名、描述、作者、依赖类型等。一路回车用默认值也行，关键一步是问你是否要添加依赖（如 monolog/monolog），先选 n，后续再加。

执行完会在当前目录生成 composer.json，内容类似：

{
    "name": "my-site/app",
    "type": "project",
    "authors": [
        {
            "name": "You",
            "email": "you@example.com"
        }
    ],
    "require": {}
}

登录后复制

3. 安装和使用一个包（以 monolog 为例）

运行命令安装日志库：

composer require monolog/monolog

登录后复制

Composer 会做三件事：
• 下载 monolog/monolog 及其依赖到 vendor/ 目录
• 更新 composer.json 的 require 字段
• 生成或更新 vendor/autoload.php

接下来，在你任意PHP文件（比如 index.php）顶部加入：

Block Survey

BlockSurvey是一个保护隐私和数据安全调查工具，可以让你使用AI来创建调查表单。

查看详情

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

use MonologLogger;
use MonologHandlerStreamHandler;

$logger = new Logger('app');
$logger->pushHandler(new StreamHandler('app.log', Logger::WARNING));
$logger->warning('Hello from Composer!');
?>

登录后复制

刷新页面，就会生成 app.log 文件，说明成功了。

4. 自动加载自己的代码（PSR-4）

不想把所有类都手动 require？Composer 可以帮你自动加载。假设你项目结构是：

my-site/
├── src/
│   └── Helper.php
├── index.php
└── composer.json

登录后复制

在 Helper.php 中写一个命名空间类：

<?php
namespace MySite;

class Helper {
    public static function greet() {
        return 'Hello from src!';
    }
}

登录后复制

编辑 composer.json，添加 autoload 配置：

"autoload": {
    "psr-4": {
        "MySite\": "src/"
    }
}

登录后复制

然后运行：

composer dump-autoload

登录后复制

现在 index.php 就可以直接用：

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

use MySiteHelper;

echo Helper::greet(); // 输出：Hello from src!

登录后复制

基本上就这些。Composer 不复杂，但容易忽略两点：一是必须 require vendor/autoload.php 才能用第三方包；二是自己写的类要配 autoload 并运行 dump-autoload 才生效。

以上就是如何在PHP原生项目（非框架）中集成和使用Composer？（从零开始）的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

为什么执行composer update后项目崩溃了？（常见原因分析）如何为Composer配置Artifactory作为远程仓库_JFrog Artifactory与PHP Composer的集成指南如何使用Composer和Phing/Ant结合，构建复杂的PHP项目？（构建工具集成）如何从 Composer 1 无缝升级到 Composer 2？如何通过Composer别名（alias）解决包冲突？（高级技巧）