PHP项目的“苦逼”经历与思考
PHP零基础,但由于项目人手不够的原因,被安排到一个用户“定制”项目。该项目是用PHP生成的统计数据报表。而用户又有新的3个需求,需要在已有的代码基础上完成。
一、初识PHP
由于本人之前没有接触过PHP代码工程,所以需要花费一点时间过一下PHP的基本语法。个人感觉和C++很像,有类的定义、继承和派生,但其又比C++简化很多,没有C++、C的数据类型的概念,所有数据想用什么直接声明赋值即可。并且,其字符串很强大,可以嵌套定义,是C的字符串、结构体、联合体、枚举类型等的组合体,可谓“一专多能”。
做到对基本语法有大致的了解,一些通用函数基本是现用现查。
二、代码结构梳理
定制项目的特点:在已有功能相对完善的基础上,增加或修改新的功能,以达到用户的“定制”需求。需求会有《**需求说明书》可供参考。
因为项目周期短,基本是直奔主题。期间采用了“关键字”搜索的方法,缩小代码范围。但由于代码结构甚是庞大,且“先辈”少给代码注释,整个代码的跟进进展一直很慢。没有方向感,感觉代码“跳来跳去”,又回头初始读的地方,“串不成线”。
整个过程持续了5天,龟速前行。
三、找准“入口”、实现功能
从项目实现新功能或修改功能的“全景”统筹视角,要达到用户需求,需要以下几步:
第一步:找到“代码”新增或修改的入口点,可能不止一处,可能会涉及多个PHP文件,在走读代码的过程中,对这些“可疑点”都要堤防并标注便于自己查找的记号。
第二步:在读懂“可疑点”代码逻辑的基础上新增或修改代码,并自己反复测试,直至达到客户功能。
第三步:形成补丁包或者增量包,提交测试部门测试,待测试无误后提供用户验收。
第一步非常关键,往往会花去整个项目的近一半的时间。
期间需要结合新功能的实现及已有代码框架进行思考,以找准“入口”。如,要实现报表新增数据,数据从哪而来?数据可能和mysql数据库有关,要从数据库里获取统计分类数据,已有的数据是如何获取的?新统计数据的获取是否要修改SQL语句才能达到?如何修改?这样修改前台能显示正确吗?是不是需要先后台验证?……
四、思考
从项目高效达成目标的角度和自己欲哭无泪的苦逼经历,特思考以下几点供跨语言开发和未来项目借鉴。
第一、“工欲善其事,必先利其器”。
代码初期,由于SourceInsight对PHP代码支持的不好,所以用Nodepad++去读代码,其不同PHP文件代码跳转的痛苦可见一斑。后来,搜索发现其实SourceInsight对PHP是支持的,网友有提供配置方法。这样,搜索关键词及代码跳转又高效了不少。再后来,从高手哪里发现,这种前台的代码实际上可以通过Subline Text2进行阅读的,试验了下,的确好用,一直用到现在。
所以,好的代码编辑、编译工具会让你思路相对顺畅,提高工作效率。
第二、“顺藤才能摸瓜”。
多么复杂的代码,只要别人能写出来并且能实现功能,我们看不懂。不要“骂娘”,不要埋怨代码注释不够,静下心来花些时间去“顺藤”,去理顺代码逻辑,这样你才能逐步建立起代码框架的整体思维。
“顺藤”一方面可以走读代码去顺,当代码逻辑非常复杂时候,可以通过打印日志的方式去打印关键函数,以此理顺代码的调用关系。两种方法结合会事半功倍。
初期,由于时间原因,可以先徒手在本上画出流程图,供走读代码参考。待项目总结时再画出规范流程图,以备后用。
“藤”理顺了,新增和修改代码就不会那么繁琐。之前也强调,“顺藤”的时间要远远大于“摸瓜”的时间。所以,前期要有耐心,切记浮躁。
第三、细节很重要。
我在修改代码时,需要往数组里新加成员。误将“dataRow”写成“dateRow”,PHP误认为是新的定义成员,并没有报语法错误。导致我在另一个PHP文件获取新增值总是获取不到。我逐步缩小范围排查,缩小至写入的区域,函数前、函数内部、函数后都新增日志打印对比。这样还是没有发现问题根源。但确认问题就出在写入部分,最后近1天时间才发现问题所在,就是前面提及的拼写错误。
其实类似的错误,一些编译环境都能通过“补全”避免掉,有的语言还会报语法错误。但细心是程序员的必备的品质,当引以为戒。
第四、不宜贪多,一个一个来。
项目需求多时,看到那么多的需求和为数不多的时间容易使得自己凌乱。所以,需求要一个一个去实现。不要一把抓,一把抓往往成为沙漏,只能抓住一点。一个小功能完成实现后,要知道自己的Next。如此Next、Next递推下去,项目就能相对紧凑的完成。
2014-6-18 pm20:58思于家中床前
作者:铭毅天下
转载请标明出处,原文地址:http://blog.csdn.net/laoyang360/article/details/32175701
如果感觉本文对您有帮助,请点击‘顶’支持一下,您的支持是我坚持写作最大的动力,谢谢!
PHP项目的“苦逼”经历与思考,布布扣,bubuko.com
原文:http://blog.csdn.net/laoyang360/article/details/32175701