本篇文章为大家展示了Yii框架如何在PHP中使用,内容简明扼要并且容易理解,绝对能使你眼前一亮,通过这篇文章的详细介绍希望你能有所收获。
扩展是专门设计的在Yii应用中随时可拿来使用的,并可重发布的软件包,例如,yiisoft/yii2-debug扩展在你的应用的每个页面底部添加一个方便用于调试的工具栏,帮助你简单地抓取页面生成的情况。你可以使用扩展来加速你的开发过程。
信息:本文中我们使用的术语“扩展”;特指Yii软件包。而用术语“软件包“;和“库”;指代非Yii专用的通常意义上的软件包。
<强>使用扩展
要使用扩展,你要先安装它。大多数扩展以作曲家软件包的形式发布,这样的扩展可采取下述两个步骤来安装:
修改你的应用的作曲家。json文件,指明你要安装的是哪个扩展(作曲家软件包)。
运行作曲家安装来安装指定的扩展。
注意如果你还没有安装作曲家,你需要先安装。
默认情况,作曲家安装的是在Packagist中注册的软件包——最大的开源作曲家代码库。你可以在Packageist中查找扩展。你也可以创建你自己的代码库然后配置作曲家来使用它。如果是在开发私有的扩展,并且想只在你的其他工程中共享时,这样做是很有用的。
通过作曲家安装的扩展会存放在BasePath/供应商目录下,这里的BasePath指你的应用的基本路径。因为作曲家还是一个依赖管理器,当它安装一个包时,也将安装这个包所依赖的所有软件包。
例如想安装yiisoft/yii2-imagine扩展,可按如下示例修改你的作曲家。json文件:
安装完成后,你应该能在BasePath/供应商目录下见到yiisoft/yii2-imagine目录。你也应该见到另一个想象/想象目录,在其中安装了所依赖的包。
信息:yiisoft/yii2-imagine是Yii由开发团队维护一个核心扩展,所有核心扩展均由Packagist集中管理,命名为yiisoft/yii2-xyz,其中的xyz,不同扩展有不同名称。
现在你可以使用安装好的扩展了,好比是应用的一部分。如下示例展示了如何使用yiisoft/yii2-imagine扩展提供的Yii \想象\图片类:
信息:扩展类由Yii类自动装卸机自动加载。
<强>手动安装扩展
在极少情况下,你可能需要手动安装一部分或者全部扩展,而不是依赖作曲家。想做到这一点,你应当:
下载扩展压缩文件,解压到供应商目录。
如果有,则安装扩展提供的自动加载器。
按指导说明下载和安装所有依赖的扩展。
如果扩展没有提供类的自动加载器,但也遵循了PSR-4标准标准,那么你可以使用Yii提供的类自动加载器来加载扩展类。你需要做的仅仅是为扩展的根目录声明一个根别名。例如,假设在供应商/mycompany myext目录中安装了一个扩展,并且扩展类的命名空间为myext,那么你可以在应用配置文件中包含如下代码:
<强>创建扩展
在你需要将你的杰作分享给其他人的时候,你可能会考虑创建一个扩展。扩展可包括任何你喜欢的代码,例如助手类,挂件,模块,等等。
建议你按照作曲家包的条款创建扩展,以便其他人更容易安装和使用只
以下是将扩展创建为一个作曲家软件包的需遵循的基本步骤。
为你的扩展建一个工程,并将它存放在版本控制代码库中,例如github.com。扩展的开发和维护都应该在这个代码库中进行。
在工程的根目录下,建一个作曲家所需的名为作曲家。json的文件。
在一个作曲家代码库中注册你的扩展,比如在Packagist中,以便其他用户能找到以及用作曲家安装你的扩展。
作曲家。json
每个作曲家软件包在根目录都必须有一个作曲家。json文件。该文件包含软件包的元数据。你可以在作曲家手册中找到完整关于该文件的规格。以下例子展示了yiisoft/yii2-imagine扩展的作曲家。json文件。
