Codelgniter4中文手册，版本4.0.0 可以通过多种方式在你的系统中来使用Composer安装CodeIgniter。 前两种方法描述了使用CodeIgniter4来创建一个项目的骨架结构，从而让你可以在一个 新的webapp中作为基础来使用。而第三种技术，如下所述，使得你可以将CodeIgniter.4 加入进一个现存的webapp中。 注意：如果你正使用一个Git仓库来存储代码或与他人写作，那么vendor目录就需 要添加到gitignore文件中。在这种情况下，当你克隆仓库到新系统中，就需要执行 composer update指令 启动应用 Codelgniter4应用启动仓库里通过composer依赖最新版本的框架来维护了一个基础 骨架的应用。 以下安装教程适用于每一位希望启动一个新的基于CodeIgniter4的项目的开发者。 安装和设置 在你的项目根目录执行以下命令： composer create-project codeigniter4/appstarter project-root 该指令将会创建一个“project-.root”目录。 如果你忽略了”project--root”参数，该命令就会创建一个”appstarter'”目录，该目录 当需要时可以被重命名。 如果你不需要或不想安装PHPUnit以及跟它相关的任何Composer依赖，请在该命令 的尾部增加”-no-dev”选项。这一操作将只会使用Composer安装框架本体以及三个 我们打包过的可信赖的外部依赖包。 下面是一个这样的安装指令的示例，使用默认的项目根目录”APPstarter”: composer create-project codeigniter4/appstarter --no-dev 安装完成后你应该根据“升级”这节里的步骤继续进行。 升级 每当有新的发布时，在你项目的根目录运行以下指令： composer update 如果在你创建项目时使用了”-no-dev”选项，那么在这里也一样适合这样做。composer update --no-dev 阅读升级指南，并检查指定的app/Config目录是否有内容变更。 2.1.安装 7
CodeIgniter4 中文手册, 版本 4.0.0 可以通过多种方式在你的系统中来使用 Composer 安装 CodeIgniter。 前两种方法描述了使用 CodeIgniter4 来创建一个项目的骨架结构，从而让你可以在一个 新的 webapp 中作为基础来使用。而第三种技术，如下所述，使得你可以将 CodeIgniter4 加入进一个现存的 webapp 中。 注意: 如果你正使用一个 Git 仓库来存储代码或与他人写作，那么 vendor 目录就需 要添加到 gitignore 文件中。在这种情况下，当你克隆仓库到新系统中，就需要执行 composer update 指令 启动应用 CodeIgniter 4 应用启动 仓库里通过 composer 依赖最新版本的框架来维护了一个基础 骨架的应用。 以下安装教程适用于每一位希望启动一个新的基于 CodeIgniter4 的项目的开发者。 安装和设置 在你的项目根目录执行以下命令: composer create-project codeigniter4/appstarter project-root 该指令将会创建一个“project-root”目录。 如果你忽略了”project-root”参数，该命令就会创建一个”appstarter”目录，该目录 当需要时可以被重命名。 如果你不需要或不想安装 PHPUnit 以及跟它相关的任何 Composer 依赖，请在该命令 的尾部增加”–no-dev”选项。这一操作将只会使用 Composer 安装框架本体以及三个 我们打包过的可信赖的外部依赖包。 下面是一个这样的安装指令的示例，使用默认的项目根目录”APPstarter”: composer create-project codeigniter4/appstarter --no-dev 安装完成后你应该根据“升级”这节里的步骤继续进行。 升级 每当有新的发布时，在你项目的根目录运行以下指令: composer update 如果在你创建项目时使用了”–no-dev”选项，那么在这里也一样适合这样做。composer update --no-dev 阅读升级指南，并检查指定的 app/Config 目录是否有内容变更。 2.1. 安装 7
Codelgniter4中文手册，版本4.0.0 优点 便于安装，便于升级。 缺点 你仍需要在更新后检查app/Config的变更。 结构 设置完成后你的项目中会有以下目录： app,public,tests,writable vendor/codeigniter4/framework/system vendor/codeigniter4/framework/app public (compare with yours after updating) 最新的开发版本 App Start仓库里有着builds脚本，在框架当前稳定发布版本和最新的开发版本间进 行选择。对于开发者而言，可以选择使用该脚本来获取最新的变更，不过这些变更可能 是不稳定的。 开发者用户手册可以在线访问。请注意与当前发布版本的用户手册有所不同，并独立 维护一个开发的分支。 在你的项目根目录执行以下指令： php builds development 以上的指令将会更新composer.json文件并将当前的工作仓库指向develop分支，并 在配置和XL文件中更新对应的路径。如果要回退以上变更，请执行 php builds release 在使用完builds命令后，请确保运行composer update来将你的vendor目录与最新 版本的同步。 将Codelgniter4添加到现存项目中 在”手动安装”这章中描述过的CodeIgniter4 framework仓库同样也可使用Composer 来被添加到现存的项目中。 在app目录下开发你的应用，pub1lic目录作为文档的根目录。 在你的项目根目录下： 8 章节2.开始
CodeIgniter4 中文手册, 版本 4.0.0 优点 便于安装，便于升级。 缺点 你仍需要在更新后检查 app/Config 的变更。 结构 设置完成后你的项目中会有以下目录: • app, public, tests, writable • vendor/codeigniter4/framework/system • vendor/codeigniter4/framework/app & public (compare with yours after updating) 最新的开发版本 App Start 仓库里有着 builds 脚本，在框架当前稳定发布版本和最新的开发版本间进 行选择。对于开发者而言，可以选择使用该脚本来获取最新的变更，不过这些变更可能 是不稳定的。 开发者用户手册 可以在线访问。请注意与当前发布版本的用户手册有所不同，并独立 维护一个开发的分支。 在你的项目根目录执行以下指令: php builds development 以上的指令将会更新 composer.json 文件并将当前的工作仓库指向 develop 分支，并 在配置和 XML 文件中更新对应的路径。如果要回退以上变更，请执行: php builds release 在使用完 builds 命令后，请确保运行 composer update 来将你的 vendor 目录与最新 版本的同步。 将 CodeIgniter4 添加到现存项目中 在”手动安装”这章中描述过的 CodeIgniter 4 framework 仓库同样也可使用 Composer 来被添加到现存的项目中。 在 app 目录下开发你的应用，public 目录作为文档的根目录。 在你的项目根目录下: 8 章节 2. 开始
Codelgniter4中文手册，版本4.0.0 composer require codeigniter4/framework 与前面两个composer安装方式类似，你也可以在”composer require'”命令中使用” -no-dev”参数来忽略安装PHPunit。 设置 从vendor/codeigniter4/framework中复制app,public,tests和writable目录到你的 项目根目录下。 从vendor/codeigniter.4/framework中复制env,phpunit.xml.dist and spark文件 到你的项目根目录下。 你需要设置指向vendor/codeigniter/framework的目录一通过修改app/Config/ Paths,php中的$systemDirectory变量 升级 每当有新的发布时，在你项目的根目录运行以下指令： composer update 如果在你创建项目时使用了”-no-dev”选项，那么在这里也一样适合这样做。composer update --no-dev 阅读升级指南，并检查指定的app/Config目录是否有内容变更。 专业人士 相当简单的安装方式；便于升级 贡献者 你仍需要在更新后检查app/Config的变更。 结构 设置完成后你的项目结构如下： app,public,tests,writable vendor/codeigniter4/framework/system 2.1.安装 9
CodeIgniter4 中文手册, 版本 4.0.0 composer require codeigniter4/framework 与前面两个 composer 安装方式类似，你也可以在”composer require”命令中使用” –no-dev”参数来忽略安装 PHPunit。 设置 从 vendor/codeigniter4/framework 中复制 app, public, tests 和 writable 目录到你的 项目根目录下。 从 vendor/codeigniter4/framework 中复制 env, phpunit.xml.dist and spark 文件 到你的项目根目录下。 你需要设置指向 vendor/codeigniter/framework 的目录——通过修改 app/Config/ Paths.php 中的 $systemDirectory 变量 升级 每当有新的发布时，在你项目的根目录运行以下指令: composer update 如果在你创建项目时使用了”–no-dev”选项，那么在这里也一样适合这样做。composer update --no-dev 阅读升级指南，并检查指定的 app/Config 目录是否有内容变更。 专业人士 相当简单的安装方式；便于升级 贡献者 你仍需要在更新后检查 app/Config 的变更。 结构 设置完成后你的项目结构如下: • app, public, tests, writable • vendor/codeigniter4/framework/system 2.1. 安装 9
Codelgniter4中文手册，版本4.0.0 安装翻译 如果你想充分利用系统信息的翻译，可以类似地把这些翻译加入到项目中。 在项目根目录运行以下指令： composer require codeigniter4/translations @rc 当你每次运行composer update时这些翻译文件也同样会被更新。 2.1.3运行你的应用程序 ● 初始化配置与设置 。本地开发主机 ·在Apache上部署主机 ·通过Vagrant部署主机 一个CodeIgniter4的程序能够通过以下几种方式来运行：部署在一台web服务器上， 使用虚拟化，或者使用CodeIgniter的命令行工具以便测试。本节阐述了如何使用以上 技术来进行部署，以及介绍了一些高级用法与如何做出贡献。 如果Codelgniter对你来说相当陌生，请阅读用户手册中的准备开始这节来学习如何 构建一个动态的PHP应用，祝你玩得开心！ 初始化配置与设置 l.用一个文本编辑器打开app/Config/App.php文件并设置你的baseURL(网站 基础URL)。如果你希望更灵活点，也可以通过编辑.ev文件，新增或更改其中 的app.baseURL=”http://example.com”来更改baseURL. 2.如果你想要使用数据库，用文本编辑器打开app/Config/Database.php文件并 进行数据库设置。同样的，也可以在.env文件里进行如上设置。 在生产环境里需要做的另一个件事就是关闭PHP的错误报告以及其他所有的只在开发 环境里的功能。在Codelgniter中，可以通过设置ENVIRONMENT常量来进行。关于这 一特性，在文档：doc:环境</general/environments>‘中进行了更为详尽的介绍。在默 认情况下，应用程序会使用”production”(生产)环境。为了更为充分地使用所提供的 debug(问题定位)工具，你需要将环境设置为“develop'”(开发环境) 注解：如果你想要在一台wb服务器上运行你的网站。你需要修改项目线下的 writable文件夹的权限，从而使得你的web服务器的当前用户可以对它进行写入。 10 章节2.开始
CodeIgniter4 中文手册, 版本 4.0.0 安装翻译 如果你想充分利用系统信息的翻译，可以类似地把这些翻译加入到项目中。 在项目根目录运行以下指令: composer require codeigniter4/translations @rc 当你每次运行 composer update 时这些翻译文件也同样会被更新。 2.1.3 运行你的应用程序 • 初始化配置与设置 • 本地开发主机 • 在 Apache 上部署主机 • 通过 Vagrant 部署主机 一个 CodeIgniter 4 的程序能够通过以下几种方式来运行：部署在一台 web 服务器上， 使用虚拟化，或者使用 CodeIgniter 的命令行工具以便测试。本节阐述了如何使用以上 技术来进行部署，以及介绍了一些高级用法与如何做出贡献。 如果 CodeIgniter 对你来说相当陌生，请阅读用户手册中的准备开始 这节来学习如何 构建一个动态的 PHP 应用，祝你玩得开心！ 初始化配置与设置 1. 用一个文本编辑器打开 app/Config/App.php 文件并设置你的 baseURL（网站 基础 URL）。如果你希望更灵活点，也可以通过编辑 .env 文件，新增或更改其中 的 app.baseURL=”http://example.com”来更改 baseURL。 2. 如果你想要使用数据库，用文本编辑器打开 app/Config/Database.php 文件并 进行数据库设置。同样的，也可以在 .env 文件里进行如上设置。 在生产环境里需要做的另一个件事就是关闭 PHP 的错误报告以及其他所有的只在开发 环境里的功能。在 CodeIgniter 中，可以通过设置 ENVIRONMENT 常量来进行。关于这 一特性，在文档:doc: 环境 </general/environments>‘ 中进行了更为详尽的介绍。在默 认情况下，应用程序会使用”production”(生产）环境。为了更为充分地使用所提供的 debug（问题定位）工具，你需要将环境设置为“develop”(开发环境） 注解: 如果你想要在一台 web 服务器上运行你的网站。你需要修改项目线下的 writable 文件夹的权限，从而使得你的 web 服务器的当前用户可以对它进行写入。 10 章节 2. 开始
Codelgniter4中文手册，版本4.0.0 本地开发主机 CodeIgniter4中内置了一个本地开发用的主机，利用了PHP内置的web服务器并实现 了CodeIgniter的路由机制。你可以使用主目录下的如下如下命令行中的serve脚本来 启动： php spark serve 这将会启动服务器，与此同时，你可以在浏览器中输入以下http:/1 ocalhost:8080地址 来浏览你的应用。 注解： 内置的开发服务器只应该在本地开发机器上使用。绝对不要将其用于生产服务 器中 如果你想在服务器上运行一个不仅仅是localhost,而是其他站点名的网站，你需要首先 将该站点加入到你的osts文件中。该文件实际所处的位置根据不同的操作系统会存 在差异，不过对于所有Unix类型的系统（包括OSX),该文件都是位于/etc/hosts。 本地开发主机可以通过三个命令行选项来进行自定义化： ·你可以使用-host命令行选项来指定当前应用所位于的主机名： php spark serve --host=example.dev ·默认情况下，服务器在8080端口上运行；不过如果你可能会需要多个站点同时 运行，或者在8080端口上已有一个应用正在部署。那么就可以通过-port选项 来指定另一个端口： php spark serve --port=8081 ·你也可以指定不同的PHP版本，通过-pp选项，同时指定你想使用的对应的 PHP版本所处的路径： php spark serve --php=/usr/bin/php7.6.5.4 在Apache上部署主机 CodeIgniter4的webapp通常部署在一个网站主机上。在本文档中我们将Apache的 httpd进程假定为标准使用的平台。 Apache在许多平台中默认集成，不过也能够以一个安装包（其中包含数据库引擎和 PHP执行文件)从[Bitnami)上下载(https://bitnami..com/stacks/infrastructure) .htaccess 本文档中假定你可以使用“mod_rewrite”模块，该模块可以在URL中移除“index.php” 这一部分。 2.1.安装 11
CodeIgniter4 中文手册, 版本 4.0.0 本地开发主机 CodeIgniter4 中内置了一个本地开发用的主机，利用了 PHP 内置的 web 服务器并实现 了 CodeIgniter 的路由机制。你可以使用主目录下的如下如下命令行中的 serve 脚本来 启动: php spark serve 这将会启动服务器，与此同时，你可以在浏览器中输入以下 http://localhost:8080 地址 来浏览你的应用。 注解: 内置的开发服务器只应该在本地开发机器上使用。绝对不要将其用于生产服务 器中 如果你想在服务器上运行一个不仅仅是 localhost，而是其他站点名的网站，你需要首先 将该站点加入到你的 hosts 文件中。该文件实际所处的位置根据不同的操作系统会存 在差异，不过对于所有 Unix 类型的系统（包括 OS X），该文件都是位于 /etc/hosts 。 本地开发主机可以通过三个命令行选项来进行自定义化: • 你可以使用 --host 命令行选项来指定当前应用所位于的主机名: php spark serve --host=example.dev • 默认情况下，服务器在 8080 端口上运行；不过如果你可能会需要多个站点同时 运行，或者在 8080 端口上已有一个应用正在部署。那么就可以通过 --port 选项 来指定另一个端口: php spark serve --port=8081 • 你也可以指定不同的 PHP 版本，通过 --php 选项，同时指定你想使用的对应的 PHP 版本所处的路径: php spark serve --php=/usr/bin/php7.6.5.4 在 Apache 上部署主机 CodeIgniter4 的 webapp 通常部署在一个网站主机上。在本文档中我们将 Apache 的 httpd 进程假定为标准使用的平台。 Apache 在许多平台中默认集成，不过也能够以一个安装包（其中包含数据库引擎和 PHP 执行文件）从 [Bitnami] 上下载 (https://bitnami.com/stacks/infrastructure) .htaccess 本文档中假定你可以使用“mod_rewrite”模块，该模块可以在 URL 中移除“index.php” 这一部分。 2.1. 安装 11