本文标签： 程序员 php Discuz的核心代码 框架 深度学习框架
阅读优秀的代码，是技术水平成长的最佳途径。记得每个进来的新人，我都做过阅读优秀代码的要求，但几乎都只能坚持很少一段时间而已。
前晚大家还在开玩笑的讨论，都是因为看了前人的一些写法，才学会了一些乱七八糟的花招。
晚上我又开始重新阅读Discuz的核心代码，花了1h多的时间，才完成一个core文件的注释。
注释后的代码：
<?php
/**
* [Discuz!] (C)2001-2099 Comsenz Inc.
* This is NOT a freeware, use is subject to license terms
*
* $Id: class_core.php 33982 2013-09-12 06:36:35Z hypowang $
*/
error_reporting(E_ALL);
define(‘IN_DISCUZ‘, true);
define(‘DISCUZ_ROOT‘, substr(dirname(__FILE__), 0, -12));
define(‘DISCUZ_CORE_DEBUG‘, false);
define(‘DISCUZ_TABLE_EXTENDABLE‘, false);
set_exception_handler(array(‘core‘, ‘handleException‘));
if (DISCUZ_CORE_DEBUG) {
set_error_handler(array(‘core‘, ‘handleError‘));
register_shutdown_function(array(‘core‘, ‘handleShutdown‘));
}
if (function_exists(‘spl_autoload_register‘)) {
spl_autoload_register(array(‘core‘, ‘autoload‘));
} else {
function __autoload($class)
{
return core::autoload($class);
}
}
C::creatapp();
/**
* Discuz框架入口类
*/
class core
{
/**
*
* @var array 暂存所有已实例化的table对象
*/
private static $_tables;
/**
*
* @var array 暂存当前以加载类路径映射关系
*/
private static $_imports;
/**
*
* @var discuz_application 应用程序实例对象
*/
private static $_app;
/**
*
* @var discuz_memory
*/
private static $_memory;
/**
* 获取单例应用对象
* @return discuz_application
*/
public static function app()
{
return self::$_app;
}
/**
* 创建全局单例应用对象
* @return discuz_application
*/
public static function creatapp()
{
if (!is_object(self::$_app)) {
self::$_app = discuz_application::instance();
}
return self::$_app;
}
/**
* 创建Discuz体系的Table对象
* @param string $name
* @return discuz_table
*/
public static function t($name)
{
return self::_make_obj($name, ‘table‘, DISCUZ_TABLE_EXTENDABLE);
}
/**
* 创建Discuz体系下的Model对象
* @param string $name
* @return discuz_model
*/
public static function m($name)
{
$args = array();
if (func_num_args() > 1) {
$args = func_get_args();
unset($args[0]);
}
return self::_make_obj($name, ‘model‘, true, $args);
}
/**
* 创建对象实例
* @param string $name 类标识，格式 "#$pluginid#$name"
* @param string $type 代表命名空间，只支持一级,文件名也需加上这级前缀
* @param boolean $extendable 专用于table类
* @param array $p 专用于table类，传递给类的构造方法参数的数据
* @return mixed
*/
protected static function _make_obj($name, $type, $extendable = false, $p = array())
{
$pluginid = null;
if ($name[0] === ‘#‘) {
list(, $pluginid, $name) = explode(‘#‘, $name);
}
$cname = $type . ‘_‘ . $name;
if (!isset(self::$_tables[$cname])) {
if (!class_exists($cname, false)) {
self::import(($pluginid ? ‘plugin/‘ . $pluginid : ‘class‘) . ‘/‘ . $type . ‘/‘ . $name);
}
if ($extendable) {
self::$_tables[$cname] = new discuz_container();
switch (count($p)) {
case 0: self::$_tables[$cname]->obj = new $cname();
break;
case 1: self::$_tables[$cname]->obj = new $cname($p[1]);
break;
case 2: self::$_tables[$cname]->obj = new $cname($p[1], $p[2]);
break;
case 3: self::$_tables[$cname]->obj = new $cname($p[1], $p[2], $p[3]);
break;
case 4: self::$_tables[$cname]->obj = new $cname($p[1], $p[2], $p[3], $p[4]);
break;
case 5: self::$_tables[$cname]->obj = new $cname($p[1], $p[2], $p[3], $p[4], $p[5]);
break;
default: $ref = new ReflectionClass($cname);
self::$_tables[$cname]->obj = $ref->newInstanceArgs($p);
unset($ref);
break;
}
} else {
self::$_tables[$cname] = new $cname();
}
}
return self::$_tables[$cname];
}
/**
* 获取全局缓存处理对象实例
* @return discuz_memory
*/
public static function memory()
{
if (!self::$_memory) {
self::$_memory = new discuz_memory();
self::$_memory->init(self::app()->config[‘memory‘]);
}
return self::$_memory;
}
/**
* 手动导入Discuz体系下的类库
* @param string $name 文件名 文件名中如果含有/，代表文件名自动加上上一级命名空间前缀，如 ‘abc/edf/hi‘对应文件 ‘abc/edf/edf_hi.php‘
* @param string $folder 相对于/source/目录下的目录名
* @param boolean $force true代表必须要导入成功；false，代表导入失败就返回false；默认true
* @return boolean 导入结果
* @throws Exception $force参数为true时，如果导入失败就抛出异常
*/
public static function import($name, $folder = ‘‘, $force = true)
{
$key = $folder . $name;
if (!isset(self::$_imports[$key])) {
$path = DISCUZ_ROOT . ‘/source/‘ . $folder;
if (strpos($name, ‘/‘) !== false) {
$pre = basename(dirname($name));
$filename = dirname($name) . ‘/‘ . $pre . ‘_‘ . basename($name) . ‘.php‘;
} else {
$filename = $name . ‘.php‘;
}
if (is_file($path . ‘/‘ . $filename)) {
include $path . ‘/‘ . $filename;
self::$_imports[$key] = true;
return true;
} elseif (!$force) {
return false;
} else {
throw new Exception(‘Oops! System file lost: ‘ . $filename);
}
}
return true;
}
public static function handleException($exception)
{
discuz_error::exception_error($exception);
}
public static function handleError($errno, $errstr, $errfile, $errline)
{
if ($errno & DISCUZ_CORE_DEBUG) {
discuz_error::system_error($errstr, false, true, false);
}
}
public static function handleShutdown()
{
if (($error = error_get_last()) && $error[‘type‘] & DISCUZ_CORE_DEBUG) {
discuz_error::system_error($error[‘message‘], false, true, false);
}
}
/**
* 用于向PHP注册Discuz框架下(source/class/)类的自动加载规则
*
* Discuz框架的自动加载规范既不遵循PSR-0，也不遵循PSR-4,都还没有完整的Vendor标识概念。
* 由于PHP底层不区分类名大小写，并且会统一转换为小写，所以Discuz根据这个原则，规定：
* 1. 所有类名和命名空间的部分都是小写，对应的文件名和目录名也是强制转为小写去匹配；
* 同时，类文件名都会带上第一级命名空间的部分，
* 如 discuz_application(我们在写的时候，为了与其它框架保持一致的风格，
* 可以写成Discuz_Application，也能正常使用) 类对应文件
* source/class/discuz/application.php；
* 2. Discuz甚至只提倡使用一级命名空间。
*
* @param string $class
* @return boolean 加载成功，返回true；除非手动调用class_exists(‘class_1‘, true)函数触发该方法时类不存在会返回false；
* 否则类加载失败时，输出错误信息并终止程序
* @see core::import()
*/
public static function autoload($class)
{
$class = strtolower($class);
if (strpos($class, ‘_‘) !== false) {
list($folder) = explode(‘_‘, $class);
$file = ‘class/‘ . $folder . ‘/‘ . substr($class, strlen($folder) + 1);
} else {
$file = ‘class/‘ . $class;
}
try {
self::import($file);
return true;
} catch (Exception $exc) {
$trace = $exc->getTrace();
foreach ($trace as $log) {
if (empty($log[‘class‘]) && $log[‘function‘] == ‘class_exists‘) {
return false;
}
}
discuz_error::exception_error($exc);
}
}
/**
* 开启性能分析
* @param string $name 跟踪标识,命名格式 "#分组#标识名称" 或者"标识名称"
*/
public static function analysisStart($name)
{
$key = ‘other‘;
if ($name[0] === ‘#‘) {
list(, $key, $name) = explode(‘#‘, $name);
}
if (!isset($_ENV[‘analysis‘])) {
$_ENV[‘analysis‘] = array();
}
if (!isset($_ENV[‘analysis‘][$key])) {
$_ENV[‘analysis‘][$key] = array();
$_ENV[‘analysis‘][$key][‘sum‘] = 0;
}
$_ENV[‘analysis‘][$key][$name][‘start‘] = microtime(TRUE);
$_ENV[‘analysis‘][$key][$name][‘start_memory_get_usage‘] = memory_get_usage();
$_ENV[‘analysis‘][$key][$name][‘start_memory_get_real_usage‘] = memory_get_usage(true);
$_ENV[‘analysis‘][$key][$name][‘start_memory_get_peak_usage‘] = memory_get_peak_usage();
$_ENV[‘analysis‘][$key][$name][‘start_memory_get_peak_real_usage‘] = memory_get_peak_usage(true);
}
/**
* 停止性能分析
* @param string $name 跟踪标识 格式与开启方法参数同
* @return array 返回指定标识的性能参数内容，格式为：
* [
* time => ,
* stop_memory_get_usage => ,
* stop_memory_get_real_usage => ,
* stop_memory_get_peak_usage => ,
* stop_memory_get_peak_real_usage =>
* ]
*/
public static function analysisStop($name)
{
$key = ‘other‘;
if ($name[0] === ‘#‘) {
list(, $key, $name) = explode(‘#‘, $name);
}
if (isset($_ENV[‘analysis‘][$key][$name][‘start‘])) {
$diff = round((microtime(TRUE) - $_ENV[‘analysis‘][$key][$name][‘start‘]) * 1000, 5);
$_ENV[‘analysis‘][$key][$name][‘time‘] = $diff;
$_ENV[‘analysis‘][$key][‘sum‘] = $_ENV[‘analysis‘][$key][‘sum‘] + $diff;
unset($_ENV[‘analysis‘][$key][$name][‘start‘]);
$_ENV[‘analysis‘][$key][$name][‘stop_memory_get_usage‘] = memory_get_usage();
$_ENV[‘analysis‘][$key][$name][‘stop_memory_get_real_usage‘] = memory_get_usage(true);
$_ENV[‘analysis‘][$key][$name][‘stop_memory_get_peak_usage‘] = memory_get_peak_usage();
$_ENV[‘analysis‘][$key][$name][‘stop_memory_get_peak_real_usage‘] = memory_get_peak_usage(true);
}
return $_ENV[‘analysis‘][$key][$name];
}
}
/**
* 框架入口类，core的类名简写
* @see core
*/
class C extends core
{
}
/**
* DB访问对象，主要是使用其静态方法 类名简写
* @see discuz_database
*/
class DB extends discuz_database
{
}
对于这种框架性的代码，不熟悉的话，因为牵涉太多，可能觉得无从下手。所以，一般是先多花一点时间，搞清楚代码的目录结构，做到了然于胸。
下一步，整理文件之间的依赖关系，最好整理成独立的文字，帮大脑形成直观的印象。
然后找准入口文件，从依赖最少的部分看起，越是Library类型的，依赖的东西越少，但一两个lib看过后暂时就没必要看下去了。还是得从框架入口看起，搞清楚框架的运行原理和加载流程。我们的大脑都进灰了，思维没有那么清晰，这个过程，也需要笔记的辅助。
尽可能多做注释，从每个类的含义、包含的功能、每个方法的参数返回值类型、方法的用法举例，实现的原理等，通过注释文字，还原代码作者的思想，进而吸收转换成自己的思想。
判断你会否阅读代码的基本标准，就是能否将代码注释得清晰明了，不再需要额外的辅助文档。因为，从技术人员的角度，代码中的注解性文档，是可以通过工具如phpdoc生成api文档的，相对于一件事情多种作用。无法编写代码，还是阅读代码，都得注意程序设计过程中思路清晰、目标明确。
本文来源：http://www.cnblogs.com/x3d/
写在最后：FOR Freedom 看看外边的世界，以及IT这一行，少不了去Google查资料，最后，安利一个V——PN代理。一枝红杏 加速器，去Google查资料是绝对首选，连接速度快，使用也方便。我买的是99￥一年的，通过这个链接（http://my.yizhihongxing.com/aff.php?aff=2509）注册后付费时输上优惠码wh80，平摊下来，每月才7块钱，特实惠。
本文标签： 程序员 php Discuz的核心代码 框架 深度学习框架
转自 SUN‘S BLOG - 专注互联网知识，分享互联网精神！
原文地址： 《从阅读Discuz的核心代码并给出注释的经历分析程序员该如何阅读代码?》
相关阅读： 《Tensorflow【机器学习】:关于fast neural style【快速风格化图像】的理解和实现》
相关阅读:《我是 G 粉，一直关注 Google，最近 Google 有一些小动作，可能很多人不太了解》
相关阅读:《机器学习引领认知领域的技术创新，那么SaaS行业会被机器学习如何改变？》
相关阅读:《VPS 教程系列：Dnsmasq + DNSCrypt + SNI Proxy 顺畅访问 Google 配置教程》
相关阅读: 对程序员有用：2017最新能上Google的hosts文件下载及总结网友遇到的各种hosts问题解决方法及配置详解
相关阅读:《Aaron Swartz – 互联网天才开挂的人生历程：每时每刻都问自己，现在这世界有什么最重要的事是我能参与去做的？》
相关阅读:《网站环境apache + php + mysql 的XAMPP，如何实现一个服务器上配置多个网站？》相关阅读:《什么是工程师文化？各位工程师是为什么活的？作为一个IT或互联网公司为什么要工程师文
原文地址：http://whosmall.com/?post=276