PHP安装Yii框架及环境配置详解

本文详细介绍了如何在PHP环境中安装和配置Yii框架，旨在帮助开发者快速搭建Yii应用。首先，确保PHP环境和Composer已正确安装，并通过Composer创建基础版或高级版Yii项目。随后，文章深入讲解了PHP版本和扩展要求，包括mbstring、intl等关键扩展的启用方法。针对Composer安装过程中可能遇到的问题，如内存限制、网络问题和版本冲突，提供了详细的解决方案。最后，文章分别针对Apache和Nginx服务器，给出了具体的Web服务器配置指南，确保Yii应用能够通过浏览器正常访问。通过本文，读者可以系统地掌握Yii框架的安装与环境配置，为后续的Yii应用开发打下坚实基础。

安装Yii框架需先确保PHP环境和Composer就绪，再通过composer create-project命令创建基础或高级版应用，随后配置Web服务器将入口指向项目web目录，并检查PHP版本及必要扩展如mbstring、intl等是否启用。

安装Yii框架，说白了，就是把它的核心代码和依赖项弄到你的项目里，然后告诉你的Web服务器去哪里找它。最主流、也是我个人推荐的方式，是利用Composer这个PHP的包管理工具来完成。它能帮你处理好各种版本依赖，省心不少。

解决方案

要让Yii跑起来，首先得确保你的PHP环境是OK的，并且Composer已经安装好了。这就像盖房子，地基和工具都得先备齐。

第一步，当然是确保Composer已经全局可用。如果你还没装，去Composer官网（getcomposer.org）找找安装教程，几行命令的事，不难。

接下来，我们用Composer来创建Yii项目。Yii 2.0有两个主要的应用模板，一个是基础版（basic），一个是高级版（advanced）。大多数时候，基础版就够用了，它结构简洁，适合小型项目或API服务。高级版则自带前后端分离，适合大型、复杂的应用。

创建基础版应用：

打开你的终端或命令行工具，切换到你希望创建项目的目录，然后运行：

composer create-project --prefer-dist yiisoft/yii2-app-basic basic-app

这里的basic-app是你项目的名称，你可以改成任何你喜欢的名字。Composer会下载Yii框架的核心文件以及所有必要的依赖。这个过程可能需要一些时间，取决于你的网络状况。

创建高级版应用：

如果你确定需要前后端分离的复杂结构，可以这样：

composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced-app

安装完成后，进入到你新创建的项目目录（比如cd basic-app）。你会发现里面有一个web目录，这很重要，因为它是你应用对外暴露的入口。

最后一步是初始化项目。对于高级版应用，这尤其关键，因为它会生成一些必要的配置文件。在项目根目录运行：

php init

根据提示选择开发环境或生产环境。

至此，Yii的代码已经躺在你的硬盘里了。但要让浏览器能访问它，还需要配置你的Web服务器，比如Apache或Nginx。

Yii框架对PHP版本和扩展有什么具体要求？

说实话，Yii框架对PHP版本的要求，其实是随着时间推移不断提高的。Yii 2.0刚出来那会儿，PHP 5.4就能跑起来，但现在，我个人强烈建议你至少使用PHP 7.2或更高版本。不仅仅是因为性能上的巨大提升（PHP 7.x比5.x快太多了），更是为了能享受到更多现代PHP的语法特性和安全更新。如果你还在用PHP 5.x，那真的该考虑升级了，很多新的库和工具都已经不再支持它了。

除了PHP版本，Yii框架还需要一些核心的PHP扩展才能正常工作。这些扩展通常在PHP安装时就默认启用了，但检查一下总没错。

• mbstring: 用于处理多字节字符串，对中文支持尤其重要。
• intl: 国际化扩展，如果你需要处理多语言、日期格式化等，它必不可少。
• pdo及其驱动: 比如pdo_mysql、pdo_pgsql等，根据你使用的数据库来选择。这是Yii数据库层的基础。
• openssl: 用于加密解密操作，Composer在下载依赖时也会用到。
• gd或imagick: 如果你的应用需要处理图片（比如验证码、图片上传缩略图），就需要其中一个。
• fileinfo: 用于文件类型检测，在文件上传时很有用。
• curl: 如果你的应用需要发起HTTP请求到外部服务，这个扩展会派上用场。

检查这些扩展是否启用，可以在命令行运行php -m查看已加载的模块列表，或者创建一个phpinfo()文件在浏览器中查看。如果缺少了，你需要编辑php.ini文件，取消对应扩展前的注释（;），然后重启你的Web服务器。

Composer安装Yii时遇到问题怎么办？

Composer在安装Yii或者其他任何PHP包时，确实偶尔会出点小岔子。这很正常，毕竟网络环境、权限、依赖冲突这些都是变数。

一个常见的问题是内存限制。Composer在处理大量依赖时，可能会超出PHP的默认内存限制。你会看到类似“Allowed memory size of X bytes exhausted”的错误。解决办法是临时提高PHP的内存限制，你可以在运行Composer命令时加上php -d memory_limit=-1，比如：

php -d memory_limit=-1 /usr/local/bin/composer create-project ...

或者，直接修改你的php.ini文件，把memory_limit设置成一个更大的值，比如512M或1G。

另一个是网络问题。如果你的网络不稳定，或者访问Composer的Packagist仓库速度慢，可能会导致下载失败。有时候，切换一下网络环境，或者配置Composer使用国内镜像源（比如阿里云Composer镜像）能有效解决：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

这能显著加快下载速度。

版本冲突也是一个头疼的问题。当你项目里已经有一些依赖，再引入Yii时，如果Yii要求的某个包版本和现有包冲突，Composer会报错。这时候，你需要仔细阅读错误信息，它会告诉你哪些包冲突了，以及冲突的原因。通常，你可以尝试更新Composer本身（composer self-update），或者检查一下你的composer.json文件，看看是否有不必要的固定版本号，尝试放宽版本限制（比如从~2.0.0到^2.0）。

有时候，缓存问题也会捣乱。Composer有自己的缓存，偶尔清一下能解决一些奇怪的问题：

composer clear-cache

遇到问题不要慌，仔细看Composer给出的错误信息，它通常会告诉你问题出在哪里，以及可能的解决方案。这就像编程中调试bug一样，是必经之路。

如何配置Web服务器以运行Yii应用？

Web服务器的配置是让Yii应用在浏览器中可见的关键一步。无论是Apache还是Nginx，核心思想都是将你的域名或IP地址指向Yii项目根目录下的web文件夹。这个web文件夹是Yii应用的入口，里面有index.php文件，所有请求都会通过它来处理。

对于Apache服务器：

你需要启用mod_rewrite模块，这是Yii美化URL（Friendly URLs）的基础。在你的Apache配置文件（通常是httpd.conf或位于conf.d/、sites-available/下的虚拟主机配置文件）中，确保有类似这样的一行：

LoadModule rewrite_module modules/mod_rewrite.so

然后，为你的Yii应用创建一个虚拟主机配置。例如：

<VirtualHost *:80>
    ServerName your-domain.com # 替换成你的域名或IP
    DocumentRoot "/path/to/your/yii-app/web" # 替换成你Yii项目的web目录绝对路径

    <Directory "/path/to/your/yii-app/web">
        # 允许.htaccess文件中的指令覆盖父目录的设置
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    # 如果你希望日志文件独立，可以配置
    ErrorLog "${APACHE_LOG_DIR}/your-domain-error.log"
    CustomLog "${APACHE_LOG_DIR}/your-domain-access.log" combined
</VirtualHost>

特别要注意DocumentRoot要指向web目录，并且在块中设置AllowOverride All，这样Yii自带的.htaccess文件才能生效，实现URL重写。配置完成后，别忘了重启Apache服务。

对于Nginx服务器：

Nginx的配置相对简洁高效。你需要在Nginx的sites-available目录（或conf.d）下创建一个新的配置文件，比如your-domain.conf：

server {
    listen 80;
    server_name your-domain.com; # 替换成你的域名或IP
    root /path/to/your/yii-app/web; # 同样指向Yii项目的web目录

    index index.php;

    charset utf-8;

    location / {
        # 尝试直接访问文件，如果不存在，则将请求重写到index.php
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        # 确保php-fpm服务正在运行
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/var/run/php/php-fpm.sock; # 根据你的php-fpm配置修改
        # 或者 fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param HTTPS on; # 如果你的应用在HTTPS下运行
    }

    # 阻止访问敏感文件
    location ~ /\.ht {
        deny all;
    }

    location ~ /(protected|framework|config|common|mail|runtime|vendor|build)/ {
        deny all;
    }
}

这里同样，root指令指向的是web目录。location /块中的try_files指令是实现URL重写的关键，它会尝试查找文件，如果找不到，就将请求转发给index.php。location ~ \.php$块则是配置Nginx如何将PHP请求交给PHP-FPM处理。配置完成后，记得创建软链接到sites-enabled并重启Nginx服务。

无论是Apache还是Nginx，配置完成后，在浏览器中访问你的域名或IP，如果看到Yii的欢迎页面，那就说明环境配置成功了。如果遇到404或500错误，通常是路径、权限或者URL重写规则的问题，需要仔细检查日志文件来定位。

今天关于《PHP安装Yii框架及环境配置详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于php,Web服务器,Composer,环境配置,Yii框架的内容请关注golang学习网公众号！