一步步教你编写不可维护的 PHP 代码

翻译 Summer ⋅ 于 2周前 ⋅ 最后回复由 ikin 6小时前 ⋅ 3473 阅读 ⋅ 原文地址
这是一篇社区协同翻译的文章,已完成翻译,更多信息请点击 协同翻译介绍

file

随着失业率越来越高,很多人意识到保全自己的工作是多么的重要。那么,什么是保住自己工作,并让自己无可替代的好方法呢?一个很简单的事实是只要你的代码没有人能够维护,那么你就成功保住了工作。编写不可维护的代码是一个特殊的技能,但奇怪的是,似乎对某些开发者来说是很自然的。不过对于剩下的开发者来说,这里有一些技巧和提示来让你开始写不可维护的代码。

simpleT 翻译于 2周前

首先要做的事情

第一步,从找工作开始。你应该寻找合适的公司,在那里你可以尽情发挥并实现你那不可维护的潜力。 你不一定需要成为公司的 PHP 大牛如果是那更好。找工作时,如果工作描述提到需要从其它的迁移到 PHP (所以你知道你会做主),或者也可以搜索那种需要10年 PHP5 工作经验的误导性工作,再加上熟练使用 FrontPage 和 Netscape Composer 。

一旦你获得这种千载难逢的机会,从第一天开始就要采取措施。在会议上发言,让你的意见被听到。大胆谈论面向对象的架构设计,企业,改革方案,怎样让够好变得更好,当然你也得做出相应的承诺。确保每个人在重要的编码环节都咨询你的意见。

王成涛 翻译于 2周前

不可维护的核心

灵感来源于优秀的文章 “Writing unmaintainable code” (想要保住工作的人一定会看的), 以下是你需要掌握和精通的两个重要概念:

  1. 你应该让别人无法轻易地修改任何东西,除非他破坏另外一些东西。

    维护人员没有时间去理解你的代码。 可维护的代码意味着能够在堆积如山的代码中快速定位到特定的部分,能够快速明白它是如何工作的并且在不破坏一些东西的情况下进行修改。你不能这样做。 不能让别人能轻易地搜索到某些东西或者在他们期待的地方找到。

  2. 你的代码不能“看起来”不可维护(因为别人会怀疑的), 它必须“是”不可维护。

    代码在维护人员看起来应该是正常的,但要在他们最意想不到的时候给他们一个惊喜。

hiwynn 翻译于 2周前

最佳实践

  1. 禁止代码约定。 关于编码和命名约定的对骂无穷无尽。这样的情况绝不能在你优秀的组织中出现。你有牛逼的项目要做,你不可能花上无数的时间来讨论用 tab 还是还是空格。再说了,约定就是限制。如果一个新人入职,并且他不习惯你的约定,他会很痛苦。不快乐的程序员是没有效率的程序员。谁问你你就向他们解释。让每个人都用他们自己喜欢的风格写代码。至于你自己的代码 - 变换你的约定。周一用 camelCase 小驼峰命名,周二用 all_lowercase 全小写命名,周五混合着用,在每个 2 月 29 日 使用匈牙利命名法。
  2. 不写注释。 你的代码很优美,它不需要注释。如果有人不理解你的代码,那么很有可能他们不是那么好的程序员。如果,有这个可能的话,你被强迫要求写注释,那么直接夸张的写。详细描述最明显和最不重要的代码,跳过其它的。

        // 下面这一块代码
        // 我们增加两个变量:
        // 命名为变量 a 和变量 b
        // 两个都是整数
    
        // 声明变量 a
        // 并给它赋值整数 1
        $a = 1;
        // 声明变量 b
        $b = 2;
        // 给变量 a 和 b 求和
        // 声明和初始化见上面
        // 并且将结果赋值给
        // 一个新的变量 c
        $c = $a + $b;
    
truesnow 翻译于 2周前
  1. 使用记事本编码。 或者使用其他没有代码缩进展示的编辑器。使得其他人忍受痛苦最终离开团队。这样你就不用总是听他们的抱怨了。如果有人问你为什么使用记事本,准备好解释:因为它来自于 Windows (当今唯一一个,为富有创造性的程序员准备的操作系统),无需任何必要的培训,也不需要花费任何代价。我相信你能在网上找到你可以使用任何程序的参考文献,甚至包括 Word,来编写你的网页代码,但是只有记事本才是真正的权威,毕竟,你们公司雇佣的人只有你才是权威。
  2. 拒绝单元测试。 向任何质疑你的人解释,你是被雇佣过来编写高质量并且没有漏洞的代码的(因此,无需测试)。为什么会有头脑正常的人会花时间来写无关紧要的测试来证实代码能否正常运行?有些事情在生活中就像-天空是蓝色的,太阳从东方升起,你的代码是能够正常运行的,因此非常感谢。继续(就像评论一样,如果被迫接受测试,那么准备好测试那些显而易见的内容然后跳过其他的部分)
  3. 不使用模板引擎。 模板引擎能够帮助你区分业务逻辑层与展示层。它可以保证代码的可维护性所以你不能遵守这个规定。PHP 之父 Rasmus Lerdorf 说过:“PHP 就是模板引擎”。即使你迫不得已使用模板引擎,也要找到对应的方法滥用它,例如放一些业务代码在模板中,或者是小心的将HTML(和 CSS 和 JavaScript)代码混合在数据库访问层中。
    一般来说,尽可能在同一行代码中的将你的 PHP,HTML,CSS 和 JavaScript 代码理直气壮地混合在一起。在 PHP 代码中创建 JavaScript 和带内联样式的 HTML 代码。如果别人问到,告诉他们这种模式叫做“封装”,你会对你的代码负全部责任。
Explorer 翻译于 2周前
  1. 版本控制。 虽然这很难避免,但是使自己摆脱任何形式或版本控制很值得尝试。你可以在讨论的时候向大家证明这样做提高了团队成员之间的沟通,而不是去依赖冷血的版本控制软件。如果你没有说服任何人,请不要绝望。 你提交的时候可以不 commit all 。 在本地保留一些自己的代码。这样如果你以外的人试图构建和部署的话,这些小而致命的代码片段将会破坏这个项目。 如果被抓了,就辩解说这些代码还不适合展示,毕竟,你提交了能够教育初级团队的高质量的代码和优秀的解决方案。这些小男孩和小女孩将会仰望着你并充满期待!
  2. 构建一个框架。 然后你不可避免地成为架构师,你的权威毋庸置疑。这样你就可以添加一些秘密约定(当然其中大多数有时是自相矛盾的),即使是最有经验的维护人员也察觉不出。 你的框架将负责所有的事情,不需要任何人费心地去理解它,大家会很开心因为你一个人让开发变得更容易而且提高了整个公司的产能。不要以开源的方式发布你的框架,因为 a) 这个框架是公司的资产而且公司投入了人大量的资金, b) 开源社区会嘲笑你,而且这将成为你虚张声势的结局。
hiwynn 翻译于 2周前

命名相关

你的变量名应该起的神秘一些,最好只有一个字母。 这样谁都无法通过简单的搜索找到需要的内容。

类名和方法最好也使用一个字母来定义。如果你确实想定义一个正常点的名字,那就一直使用它吧 —— 记住,隐藏信息的最好方法就是频繁的使用它。 当重复使用相同名称(称为“面向对象的编程”)时,如果将圆括号和花括号放在新的一行,这将有助于提高代码的可读性,并且让队友在你的代码中寻找任何东西时,都得重温一下正则表达式。考虑一下吧:

    $noodles = 1;
    class
    noodles
    {
        var $noodles = 2;
        function
            noodles
            ()
        {
            $noodles['noodles'] = 'noodles';
        }
    }
    function
        noodles() {
            return new noodles;
        }
    $noodles = noodles();
    var_dump($noodles);

你也可以使用奇特的字符集来命名变量。西里尔字母就非常合适,因为有些字母看起来跟罗马字母一样, 但其实不是(所有这些:xopekacMEBCTAKXOPH)。那么下面的输出是:

    $alert = 1;
    $аlert = 2;
    echo $alert;

2?如果第二个 alert以西里尔字母"a"开头,则不可以!

Honvid 翻译于 2周前

引用相关

即使你非常正常的定义来一些东西,但并不意味着你不能以有趣的方式来使用它。主要的武器有:

  • eval()
  • 可变变量
  • 可变类,比如$strudels = "noodles"; $noo = new $strudels;
  • call_user_func()

基本上任何将代码视为字符串的语言结构都是你的好朋友。

    // calling abc();
    $z = 'A';
    call_user_func($z .'bC');
Honvid 翻译于 2周前

大写

字母例子,函数方法名不区分大小写,滥用这个特点。

function abc(){
    echo "abc";
}
AbC();

另一方面,数组的健(key) 对大小写敏感,也滥用这个特点。

$a['UseConvetionsOnlyTobreakThem'] = 1;
if (isset($a['UseConvetionsOnlyToBreakThem'])) {
    // ?? 大写 B !!1!
}
medz 翻译于 2周前

重写

在不期望的情况下重写全局变量,尤其是超全局变量。尽早重写$_GET数组中的属性,多次重写,$_POST亦是如此。在$_REQUEST上做一些不起眼的重写作为点缀。如果是在WTF-ed上,你可以解释是在防止用户输入的 XSS 攻击、注入攻击以及其他的病毒攻击。

控制结构

使用、混合、匹配所有备选的ifwhileforforeachswitch语法。如果被问起来,所有的这些,请解释说你正在培训新员工学习真正的语言。

if ($a > 5):
  if ($a > 4) {
      while ($a > 0):
        echo --$a;
      endwhile;
  }
endif;

嵌套三元运算符,没有比这个更好、更简洁的代码了。

// 猜猜这里输出什么
echo true ? 'true' : false ? 't' : 'f';

for的循环体内,再次增加$i以保持所有人的注意。或者,通过不使用$i来实现循环增量的惊喜。从不。

Honvid 翻译于 2周前

嵌套循环、深入,然后突然跳出它们(循环)。像 break 2break 3 这样的代码存粹是为了娱乐,尤其是当混合了奇怪的缩进代码时。

这是一个开始!

这就是今天的全部。我希望你相信你自己也能做到,你也可以编写不可维护的代码。现在你的未来就在你的手中!当然,你也可以编写可读性比较高的代码,但是冒着被替代的风险。

medz 翻译于 2周前

原文地址:http://www.phpied.com/how-to-write-unmai...

译文地址:https://laravel-china.org/topics/12848/t...


本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

本帖已被设为精华帖!
回复数量: 22
  • nthsky 1
    2周前

    Now your future is in your hands! :joy:

  • Summer MOD A Life-long learner.
    2周前

    有趣的视角,有趣的文章

  • NearTheShore Human beings are terrible messes, Andrew.
    2周前

    很皮啊 :see_no_evil:

  • rough
    2周前

    厉害了,这个

  • Nick 简单就好!
    2周前

    :cry:

  • 熊能 这个人很懒,但他留下了什么...
    2周前

    上帝都不知道你在写什么了

  • pigsney
    2周前

    反面教材大家不要学习

  • Summer MOD A Life-long learner. 3
    2周前

    @pigsney 这文章其实就是在告诉大家,『这些是很糟糕的做法,要尽量避免』。只不过用了比较诙谐的形式写出来而已。

  • miss201 今天不想跑,所以才去跑,这才是长距离跑者的思维方式
    2周前

    这么写代码过分了啊

  • truesnow
    2周前

    看到这篇有趣的文章不禁想要翻译一下😆。讨厌那些写代码没有规范,或者用的是自己的风格很差的「规范」写代码的「程序员」。了解并遵循代码规范应该是最起码的。

  • OMGZui 头像是我未来女儿,哼
    2周前

    大写的服,能写出这样的代码。

  • weijieyu
    2周前

    自带代码混淆功能?

  • niuhaisha
    2周前

    @Summer 这些问题可能大家都遇到过,如果自己写感觉是很正常的,这么跳出来看会发现这写的是什么烂代码啊 :joy:.大家都尽量避免吧,做一个合格的程序员,要不然会被后人(接替你工作的人)给骂死的.

  • Destiny UI 精美、质量超高的技术博客 https://aabvip.com/
    2周前

    。。。这篇文章。。。。 :flushed:

  • Chasers9527 代码是写给人看的,顺便给机器运行
    2周前

    因为它来自于 Windows (当今唯一一个,为富有创造性的程序员准备的操作系统) :rocket: :rocket: :rocket:

  • ab0029
    2周前

    阔以啊

  • 雪风 一个只有下班后才有时间写代码的程序员
    1周前

    命名相关这个我就在以前维护过的一个C项目中见过,看的我特别头大。

  • captain_Hu 前来社区膜拜各位大神
    1周前

    6的飞起

  • Rekkles
    1周前

    学习了

  • fanhaobai https://www.fanhaobai.com。
    1周前

    创造自己的不可替代性。

  • 赵聪
    1周前

    很皮啊 :see_no_evil:

  • ikin
    1天前

    这也是我的疑虑,从一开始写程序都被教导要规范,这规范那规范。最后发现这是一场巨大的阴谋,活在规范里,意味着你可以被别人轻易的替代, 当然如果你是老板的话一定要做好规范化 哈哈哈哈~~

暂无评论~~
您需要登陆以后才能留下评论!

Composer 中国全量镜像

Top 100 扩展包

Lumen 中文文档

Laravel 速查表

Laravel 中文文档

Laravel 项目开发规范

Laravel 开发环境部署

社区文档撰写指南

TDD 构建 Laravel 论坛笔记

PHP PSR 标准规范

PHP 设计模式全集

Dingo API 中文文档