开发实践(第三集):项目和IDE
这是一系列关于开发实践的文章的第三篇:使用像PHP Storm这样的集成开发环境(IDE)工作项目的优势。查看三月份的介绍了解您可以期待的内容。
使用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 Bug Squad"以获取Joomla许可证密钥。它还提供30天的试用期。
就像所有复杂工具一样,“有多种方法可以做到”(there's more than one way to do it),我将讨论我认为可以适应特定需求的一种通用方法。
安装
从JetBrains网站下载您的PHP Storm版本,并按照安装说明进行操作,然后您就可以继续了。
项目
我们从创建一个基于现有文件的新项目开始。这个创建过程从目录级别开始,我们将使用##PROJECTS##//local.##DOMAIN## 。
##PROJECTS##//local.##DOMAIN##/#vcs/extension | /module /www /logs /.idea
PHP Storm会创建一个名为.idea的文件夹,其中包含项目的设置。
项目选择中包含的所有文件和文件夹都会被索引、控制和从IDE中访问,以便进行检查和编辑。
项目文件
IDE支持大量文件类型,例如
.php, .css / .less / .scss, .xml, .html, .js, .ini
语法着色
在检查文件时,最简单的方法是语法着色,它可以突出显示并使代码更易于阅读。在上面的示例中,您可以看到一个PHP文件的部分代码。它支持混合语言:PHP、HTML和CSS。
语法着色对于识别遗漏的引号等错误也很有用。
折叠代码块
我们可以将一个代码块折叠成一行。
显示和导航
由于IDE实际上“阅读”代码源、注释和解释器,因此它将能够为您提供额外的信息。例如,通过按住Ctrl键并悬停在方法上,将显示使用的参数。在方法或变量上按Ctrl键并单击将导航到源文件中的确切位置。
IDE还会显示可能在未来版本中删除的已弃用方法
软件重构
在开发中,一个常数是,从长远来看,我们通常对我们编写的代码不满意。为了回到过去,我们进行软件重构(refactoring),这是一个对现有代码进行重构的过程。
PHP Storm提供了一些值得探索的惊人功能。例如,您不必使用“查找和替换”,而是右键单击变量或方法,然后选择“重构 | 重命名(rename)”。
PHP Storm将使用其对代码的知识和解释来智能地执行替换,选择应该重命名什么以及不应该重命名什么。
Joomla支持
Joomla项目有其自己的编码标准,这些标准有助于确保我们的代码具有最高质量,易于阅读、调试和维护。PHP Storm可以扩展以在IDE中提供特定的Joomla支持。
代码风格
PHP storm可以重新格式化整个代码或选中代码以获得正确的缩进、空格等。使用Joomla的特定配置文件,IDE将应用Joomla规范(参见Joomla文档)。要添加Joomla编码风格的支持,请在此下载配置文件 并将Joomla.xml文件复制到PHP storm安装目录下的/config/codestyles/ 文件夹。
打开PHP Storm的配置(PHP Storm – 设置),通过File | Settings,在搜索框中输入code 以显示并选择Joomla编码风格。
代码规范器
拥有良好的代码外观是一回事,确保代码实际上符合Joomla编码规范则是另一回事。我们需要使用代码规范器(参见Joomla文档)。
首先,使用PHP Storm文档配置codesniffer工具 。现在,打开PHP Storm的配置(PHP Storm – 设置),通过File | Settings,在搜索框中输入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/之外的第三方外部服务
评论