PHP Clean CODE如何？

Question

像我所有老师都说的那样＃34;你可以做任何事情，因为你可以，但你的代码看起来像sh **＆＃34;

所以我在互联网上寻找一些关于编写PHP代码的好教程，尽可能干净。我没有找到任何东西，所以我需要你的帮助。 我需要一些关于如何编写干净的PHP代码的教程的URL。 它也可以是BOOK！

Answer 1

我不知道你老师的意思是什么，但我非常确定编写干净的代码是编写有意义的代码。 如果它真的很难理解，那么写得更好？对我来说，干净的代码并不仅仅意味着语法或更少的代码。只需编写有意义的内容，使用最佳实践和标准。这是一个很好的开始！ 因为你带来了书籍，所以这里有一个：

• Clean Code: A Handbook of Agile Software
• The Pragmatic Programmer: From Journeyman to Master (old but great)

Answer 2

我认为这是个人品味的问题。什么时候代码干净？什么时候不是？这很难说，但您可以遵循一些通用指南来帮助改进您的代码。下面我给出了一些我使用的指南，他们到目前为止帮助了我。

1. 保持缩进一致。例如，在同一缩进级别保留相同块的代码（if语句的主体）。
2. 避免使用隐含/不清楚的变量名称。而不是写$r，而是写$result或$response。我希望你明白这个想法。
3. 避免使用神秘/不清楚的功能/方法名称。尝试使用简短的描述性名称命名您的函数，同时不牺牲可读性。它比check_directory_recursively更容易阅读和理解cdrecur。
4. 正如视频中所提到的（链接如下），功能应该只做一个的事情并且做得好。如果该函数依赖于某些与其尝试完成的功能明显不同的其他功能，请将该功能提取到另一个功能。这也有很好的副作用，您可以更轻松地重用该功能。对于函数所需的参数，命名准则也是如此。
5. 避免代码重复。这扩展到代码重用。重用代码时，您可以减少代码库，并帮助其他开发人员（以及六个月内自己）理解/使用代码。当出现相同的功能名称时，它更容易维护。如果出现错误/错误，您可以更好地了解错误的来源。
6. 坚持命名惯例。有两种广泛使用的类型： CamelCase 和 snake_case
7. 记录您的代码。使用PHPDocumentor为您的函数/方法编写好的文档。这也有一个很好的副作用，IDE可以读取它并帮助您完成代码。记住不要记录你所做的每一件事。如果您只应记录未立即显示其用途的代码。如果您正在进行一些非常复杂的计算，那么简短的注释可以帮助开发人员读取您的代码流。

然后有些东西需要时间，但要学习本机PHP函数的所有（或大部分）。利用命名空间，例外， SPL库，数组和字符串函数，我可以继续使用。使用他们的功能和课程时，您将获得3个主要好处。

1. 更简洁，更简洁的代码，其他开发人员可以更好地了解功能名称。
2. 良好的文档（大部分时间）。 PHP手册的某些方面缺乏相当多的内容。
3. 性能提升。 PHP编写的函数用a优化 比PHP自己更快的语言。但这可能不会直接显示。

然后我个人发现有用的两件事：

• 用足够的空间包围代码。有了这个我的意思是它没有 如果return的两边都有一个空行 声明。它有助于我更好地区分内部的早期回报 功能，使代码流更清晰。
• 如果额外的变量使可读性/可维护性更容易，则添加它。但请记住命名指南，不要只是添加它，因为你觉得它和今天太阳很明亮：D

您还可以观看this awesome answer中的前两个（或更多）视频。

希望这（虽然非常个人品味）可以帮助你。 快乐的编码！