实用开发3:项目
关于实用开发的系列文章的第三篇。通过集成开发环境(IDE)如PHP Storm处理项目的好处。参考本系列中的先前文章。
使用PHP Storm管理和文件
集成开发环境(IDE)如Eclipse、Netbeans、Php Storm等可以帮助提高项目的生产力。它们为PHP、JavaScript和HTML等语言提供不同级别的支持,包括突出显示、编辑、检查、重构、Joomla!编码标准、通过插件进行扩展等。
选择PHP Storm
在IDE的选择上没有“错误”的选择,这是一个个人偏好的问题。如果IDE满足你的要求并且感觉良好,就坚持下去!
在探索了几个选项后,我发现Php Storm可在所有主要平台上(Windows、Mac OS X和Linux)使用,响应迅速,用户友好,功能丰富,涵盖了开发需求的基础。在本文系列的上下文中,IDE的引用具体指的是PHP Storm。
尽管Php Storm是一个商业产品——并且对于商业开发者来说物有所值——但它对“开源开发者”是免费的。如果你正在为Joomla做出贡献,请联系“Joomla错误小组”以获取Joomla许可密钥。它附带30天的标准试用期。
与任何复杂的工具一样,有不止一种方法可以做到这一点,我将讨论我认为是一种通用的方法,可以根据特定需求进行调整。
安装
从 JetBrains 网站下载您的 PHP Storm 版本,并按照安装说明进行安装,您应该可以顺利使用了。
项目
我们从创建一个现有文件的新项目开始。这个创建从目录级别开始,我们将使用 ##PROJECTS##//local.##DOMAIN##
##PROJECTS##//local.##DOMAIN##/#vcs/extension
| /module
/www
/logs
/.idea
.idea 目录是由 PHP Storm 创建的,它包含项目设置。
所有从所选项目目录及其以下的所有文件和目录都被索引、监控,并且可以从 IDE 内部进行查看和编辑。
项目文件
IDE 将支持大量的文件类型,例如
.php, .css / .less / .scss, .xml, .html, .js, .ini
语法高亮
检查文件时最基本的支持来自于对源代码进行着色、高亮显示,使代码更易于阅读。上面的 a 展示了部分 .php 文件,支持混合语言 php、html 和 css。
但语法高亮显示在识别缺失的结束引号时也很有用。
折叠块
将代码块折叠成单行
显示和导航
因为 IDE 实际上“阅读”源代码,注释块并对其进行解释,所以它将能够提供其他信息。例如,Ctrl - 悬停方法将显示使用的参数。Ctrl - 点击方法或变量将导航到相关源文件的确切位置。
IDE 还会显示已过时的方法,那些可能在下一个版本中删除的方法
重构
在编程中,我们通常在事后对我们以前做的事情不太满意,这时就出现了重构,即重新结构现有代码的过程。
PHP Storm 提供了一些值得探索的出色功能。例如,不要使用“搜索和替换”,而是对变量或方法右键单击,然后选择重构 | 重命名。
PHP storm 将使用其对解释的了解,智能地进行搜索和替换,可能还会重命名文件等。
Joomla 支持
Joomla 项目有其自己的 编码规范,有助于确保我们的代码是最高质量的,这将使其易于阅读、调试和维护。PHP storm 可以扩展到在 IDE 中具有对 Joomla 的特定支持(见 Joomla 文档)。
代码样式
PHP storm 可以重新格式化代码或选择,使其具有正确的缩进、空格等。借助 Joomla 特定配置文件,我们可以让 IDE 以 Joomla 方式应用样式(另见 Joomla 文档)。要添加对 Joomla! 编码样式的支持,在此下载配置文件,并将 Joomla.xml 文件复制到 PHP storm 安装目录中的 /config/codestyles/。
打开 PHP Storm - 设置(通过文件 | 设置),在选项中键入 code 以显示并选择 Joomla 代码样式。
代码检查器
让代码看起来很棒是一回事,要确保代码实际上符合 Joomla 编码规范,我们需要使用代码检查器(另见 Joomla 文档)。
首先,根据 PHP Storm 文档设置 codesniffer 工具。设置 codesniffer 工具。现在打开 PHP Storm - 设置(通过文件 | 设置),在搜索框中输入 code,以显示并选择 Joomla 代码样式。现在参考代码检查器可执行文件以激活代码检查器。
##XAMPP_INSTALL##/php/phpcs.bat
接下来,我们需要安装对 Joomla 编码标准的支持。将 编码标准 解压到
##XAMPP_INSTALL##/php/pear/PHP/CodeSniffer/Standards/Joomla
或者(对于高级用户克隆)将 GIT 仓库克隆到该位置。
打开 PHP Storm - 设置(通过文件 | 设置),在搜索框中输入 inspec ,以显示并选择 Joomla 代码样式。
结果,现在我们在违反 Joomla 编码标准时会收到警告
版本控制,预处理器,构建和测试
这些主题非常重要且复杂,值得单独的文章,请耐心等待。
本系列之前的文章
发表在 Joomla 社区杂志上的一些文章代表作者对特定主题的个人观点或经验,可能不符合 Joomla 项目的官方立场
通过接受,您将访问 https://magazine.joomla.net.cn/ 外部第三方提供的服务
评论