PHP系列直播：从代码细节聊一聊如何成为一名优秀的工程师
http://i1.go2yd.com/image.php?url=0LTKDuDCoP&zhiwu55.jpg主讲人
周梦康（楚松） 点击关注专家
阿里云资深研发工程师，《深入 PHP 内核》作者之一
http://i1.go2yd.com/image.php?url=0LTKDuTsXj&zhiwu55.jpg内容提要
从代码细节聊一聊如何成为一名优秀的工程师
[*]你的代码语意清晰吗？
[*]你的代码足够健壮吗？
[*]你的代码运行安全吗？
[*]你的代码考虑性能吗？
直播时间
2019年3月12日 19：30
更多内容
更多内容可关注PHP技术进阶云栖号（http://yq.aliyun.com/teams/405）， 获取第一手技术资料
阿里开发者技术交流钉钉群的全向图【2019年】
好的语义表达是团队协作中高效迭代的润滑剂，好的语义表达是线上未知代码问题排查的指南针。
不要让其他人读不懂你的代码，其他人可能就是一周后的你。时刻以“如果你写的这段代码出现故障，一个陌生人接手你的代码需要多久能处理完这个bug”来监督自己。
日常中应该多多刻意提升自己语义表达，百利而无一害。那么我们应该从哪些细节去做好语义表达呢？
http://i1.go2yd.com/image.php?url=0LTKDu3d7o&zhiwu55.jpg以下代码全为我的艺术创作，不属于任何实际项目
命名
案例1
http://i1.go2yd.com/image.php?url=0LTKDuKgCP&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDuyG1U&zhiwu55.jpg案例2
如果仅仅有这个函数名和参数名，谁能猜到参数的意义呢？
http://i1.go2yd.com/image.php?url=0LTKDuBbuK&zhiwu55.jpg案例3
http://i1.go2yd.com/image.php?url=0LTKDuWGPS&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDu01FQ&zhiwu55.jpg案例4
假如业务代码里有这些类
http://i1.go2yd.com/image.php?url=0LTKDuiPmD&zhiwu55.jpg而我们查询数据库发现
http://i1.go2yd.com/image.php?url=0LTKDuYQQr&zhiwu55.jpg这样我们根据业务代码就非常不方便找到对应的表，而且其他人接手我们项目的时候，也会摸不着头脑。或者说这可能是三个人三次迭代开发造成的，那么他们彼此都没有去参考前面人的命名规则。
来自灵魂的拷问
http://i1.go2yd.com/image.php?url=0LTKDuH4h7&zhiwu55.jpg注释
说完命名，下面说下注释。注释里还有什么学问？Are you kidding me?
一个数组对象成员，你知道怎么写吗？
类的魔术方法调用的注释，你知道怎么写吗？
对象数组
http://i1.go2yd.com/image.php?url=0LTKDuyaJB&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDuEhsV&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDuENqP&zhiwu55.jpg@method 的使用
http://i1.go2yd.com/image.php?url=0LTKDuIWZ2&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDusvWA&zhiwu55.jpg@deprecated 使用
http://i1.go2yd.com/image.php?url=0LTKDuMOwW&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDuqSJY&zhiwu55.jpg注释其他注意事项
注释解释张冠李戴，方法名更新，方法的功能业务注释没更新；复制别人的代码把 @author 信息也复制过来了，错误了还要把锅甩给别人。
注释更多参考
函数、方法
案例1
先说明一句，不好的代码不妨碍它成为一个优秀的软件。PHP MySQL 烂代码多的去了。
找到一个开源软件里面的代码，功能非常抢到，但是这个方法内容太多，一些不足点我标注出来了。
http://i1.go2yd.com/image.php?url=0LTKDuOsyf&zhiwu55.jpg案例2
拿上面我举例子，还记得下面这种图吗？
http://i1.go2yd.com/image.php?url=0LTKDu01FQ&zhiwu55.jpg优化方案1
http://i1.go2yd.com/image.php?url=0LTKDuPLxS&zhiwu55.jpg优化方案2
http://i1.go2yd.com/image.php?url=0LTKDu9bWD&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDuxMGk&zhiwu55.jpghttp://i1.go2yd.com/image.php?url=0LTKDuqBRC&zhiwu55.jpg案例3
这还是函数吗？（不仅仅是语义，属于错误）
http://i1.go2yd.com/image.php?url=0LTKDubAzo&zhiwu55.jpg$startId和$lastId两个参数重复
案例4
尽量减少参数引用
http://i1.go2yd.com/image.php?url=0LTKDuAUoA&zhiwu55.jpg案例5
参数类型明确，返回值类型明确，不要出现 mixed。这个我直接拿官方的函数来举例，对权威也要有怀疑的眼光。纯属个人看法。
http://i1.go2yd.com/image.php?url=0LTKDueYx3&zhiwu55.jpg案例6
http://i1.go2yd.com/image.php?url=0LTKDusKu5&zhiwu55.jpg上面例子中你会发现这个addUser写得不想一个函数（方法）而像一个远程api接口。而且在右边的代码中需要每次使用的时候都要用is_array来判断。这是非常不友好的语义表达。PHP Java 这样的高级语言有异常，我们要善用异常。
http://i1.go2yd.com/image.php?url=0LTKDuUvDH&zhiwu55.jpg好的语义表达是团队协作中高效迭代的润滑剂，好的语义表达是线上未知代码问题排查的指南针。这篇博客到这里就结束了，不知道你是否有一些收获呢？
http://i1.go2yd.com/image.php?url=0LTKDu3d7o&zhiwu55.jpg更多精彩
阿里云开年Hi购季满返活动火热进行中
http://i1.go2yd.com/image.php?url=0LTKDuvyMH&zhiwu55.jpg
三七女生节，解密阿里女程序员们的代码诗！http://i1.go2yd.com/image.php?url=0LTKDu7ICQ&zhiwu55.jpg
实时计算最佳实践：基于表格存储和Blink的大数据实时计算http://i1.go2yd.com/image.php?url=0LTKDunGif&zhiwu55.jpgDubbo Mesh 在闲鱼生产环境中的落地实践
如果觉得本文还不错，点击好看一下！
页:
[1]