PHP大型项目架构开发注意事项和代码规范（ 持续总结更新）

1，所有的状态类型均不能使用数字直接表示，一律用常量或者枚举类来标识，进行统一管理和识别；

2，所有的传递参数都必须有数据类型model对应，不允许直接采用PHP键值对数组的方式进行传递；

3，所有的函数都要进行try...catch操作，避免报错时无法及时追踪；

4，所有的Exception中的message必须提示非常详情，具有全局区分性，不可用诸如，程序报错，参数报错，保存报错等毫无意义及辨识度的异常信息；

5，所有的数据库改动作都必须考虑多线程造成的争抢效应，必须采用共享锁或者排他锁进行数据锁定，而后及时进行提交事务，避免争抢造成数据异常；

6，所有的数据库增操作，都必须考虑线程加锁，采用redis进行线程加锁，避免多线程同时插入数据库，造成数据重复写入异常问题；

7，所有的异步队列操作，都不能直接发出，因为整体逻辑事务可能因逻辑抛出异常，导致事务并未提交，因此所有的异步操作，都必须在事务提交之后执行，因此采用事务封包函数进行统一处理；

8，所有的保存操作均采用save模式，在采用队列处理问题时，我们有时需要得到一个更新事件，如果在所有逻辑处都追加一个队列发送，会造成代码无法维护和管理，则采用save之后，异步处理save事件，这样的好处即事件可控性与可维护；

9，程序开发动手前，必须先画好流程图，将流程图搞清楚，搞明白，没有逻辑悖论时才能进行开发；

10，开发代码应从宏观角度下手，先定义各个逻辑的函数，进行宏观逻辑整理和分块，保证代码开发一气呵成模式，减少后续乱塞逻辑的现象。

11，要将代码留有足够的扩展余地，包括很多的前置和后置逻辑，以及定义一些事件，以便后续人员能够扩展修正数据；

12，代码一定要进行分层开发，分为model层，service层，form层，controller层，中间件层，这样在后期代码维护中起到非常重要的作用；

13，此外，要大量使用trait，减少代码的重复量，相似模型要用抽象类来抽象，避免重复代码的产生；

14，在多个接口中都要获取同一种状态时，这个功能要单独抽离出来作为一个接口服务存在，降低代码的侵入性；

15，一段代码一旦被使用2次以上，则应该进行封装，切不可偷懒，不断地封装函数的好处就是做到单元测试的正确性，从而降低后续迭代的出错率；

16，大项目中往往采用队列的方式减轻用户主线程的应答时间，将一个线程拆成了多个队列线程，此时有一个规范就是，动态数据不能从数据库中查询，只能传递当时快照信息，避免队列时间差导致的数据不一致性（举例来说，拼团支付时判断join数和成团数相等，然后丢进队列执行，队列接过来时，支付线程又将join数加1，队列如果从数据库中查询则会发现数据多出一个，程序报错，所以最好的方法，就是队列本身将核心数据随队列传输过来，不查数据库）；

17，封装的函数中，不可以有上下文的数据，比如Context::get(),\Yii::$app->user等，一个函数要保持其独立性，所有的参数都应该是既得既传的，而不能通过上下文获取，一旦又了上下午，该函数就有了局限性，不可迁移，不可复用，等同于不封装。

18，rabbitmq 延迟队列，最多延迟2的32次方-1，4294967295，解决这个问题的方式采用连续延迟方式，将最终延时时间，随着队列传递，也可以直接改用redis的zset score方式来解决延迟的问题，到点后仍然将队列扔到rabbitmq中去，让专业的软件干专业的事情；

19，hyperf 异步队列中，切记不要再发出能触发当前异步队列的异步队列，这样会造成队列执行死循环，将协程耗死，所以开发异步队列时一定要考虑异步队列绝对不能是闭环。

20，rabbimq在程序断开连接后，unacked的消息会重新变为ready状态，等下次程序重启后，重新发送让其消息，这样做好事务处理就不担心冗余数据入库了；

21，hyperf 接入rabbitmq延迟队列总是会有问题，改为hyperf的redis异步队列方式，配合rabbitmq来使用，完美解决延迟队列问题；

22，在数据库表中，如果ID为主键，却不是自增，这时要注意关闭框架自增回填逻辑，因为此时PDO的lastInsertId返回的是自增字段的值；

23，在发生异常处理事务回滚时，一定要注意第三方调用时的，该过程已经被处理了，如果被连带着一起回滚的话，会导致下次再次请求报错，因此，后期对于事务提交的事情，要思考到底那些逻辑需要一起提交，那些逻辑不需要一起提交，切不可一刀切的try catch，然后回滚了事。

24，队列方式开发一次性逻辑时，往往将一整个逻辑拆分成一个个小逻辑，此时会出现这样一个问题，例如支付完成后做一堆工作，完后确认接单，接单后再完成订单，这是三个流程，但是如果支付完成队列中有个自动接单的话，就会到这个执行时间和手动完成订单时间稍微晚一点发生，这将导致重复修改订单状态，解决方案是，要加排它锁，此外，写入状态前，务必查询一次最近一次状态，是否允许修改，这样可以避免重复写入，这个BUG非常难以发现；

25，hyperf的rabbitmq在大量队列消息同时写入，而队列消费时间又比较长的时候，就会报错，解决方式，增加心跳时间为30+，读写时间是心跳时间的2倍+，而据说swoole3.6没有此问题。

26，hyperf 开发中，created_at 和updated_at同时更新，这个不是hyperf的问题，而是数据库中两个字段被我设置成了自动更新