分析入口文件main.php

在分析之前，需要了解php cli模式下的编程

1.了解getopt函数，php手册地址：http://php.net/manual/zh/function.getopt.php

      static private $help = <<<EOF

  帮助信息:
  Usage: /path/to/php main.php [options] -- [args...]

  -h [--help]        显示帮助信息
  -p [--pid]         指定pid文件位置(默认pid文件保存在当前目录)
  -s start           启动进程
  -s stop            停止进程
  -s restart         重启进程
  -l [--log]         log文件夹的位置
  -c [--config]      config文件的位置
  -d [--daemon]      是否后台运行
  -r [--reload]      重新载入配置文件
  -m [--monitor]     监控进程是否在运行,如果在运行则不管,未运行则启动进程
  --worker           开启worker
  --tasktype         task任务获取类型,[file|mysql] 默认是file
  --checktime        默认精确对时(如果精确对时,程序则会延时到分钟开始0秒启动) 值为false则不精确对时

EOF;
    /**
     * 运行入口
     */
    static public function run()
    {
        $opt = getopt(self::$options, self::$longopts);
        self::spl_autoload_register();
        self::params_h($opt);
        self::params_d($opt);
        self::params_p($opt);
        self::params_l($opt);
        self::params_c($opt);
        self::params_r($opt);
        self::params_worker($opt);
        self::params_tasktype($opt);
        self::params_checktime($opt);
        $opt = self::params_m($opt);
        self::params_s($opt);
    }

　　如上，main.php 可以支持长短选项，以及接收参数

短选项是options 。该字符串中的每个字符会被当做选项字符，匹配传入脚本的选项以单个连字符(-)开头。 比如，一个选项字符串 "x" 识别了一个选项 -x。 只允许 a-z、A-Z 和 0-9。

长选项是longopts。此数组中的每个元素会被作为选项字符串，匹配了以两个连字符(--)传入到脚本的选项。 例如，长选项元素 "opt" 识别了一个选项 --opt。

这里有一个条件非常重要

• 单独的字符（不接受值）
• 后面跟随冒号的字符（此选项需要值）
• 后面跟随两个冒号的字符（此选项的值可选）

比如，我们试试看这个main.php -h 和 -s start 这里h是不带值的，s是可以带值的

<?php
   $options  = 's:h';
   $xx = getopt($options);
   var_dump($xx);

E:\FMS\trunk\swoole\study_swoole>php test.php -h

输出：

E:\FMS\trunk\swoole\study_swoole\test.php:4:
array(1) {
'h' =>
bool(false)
}

E:\FMS\trunk\swoole\study_swoole>php test.php -s reload

输出：
E:\FMS\trunk\swoole\study_swoole\test.php:4:
array(1) {
's' =>
string(6) "reload"
}

了解了，cli怎么获取参数，我们再去看下main.php 的run方法到底在执行什么逻辑

45行：self::spl_autoload_register();自己添加了自己支持的自动引入

46行：self::params_h($opt); 返回帮助信息，并且会直接die退出

[root@localhost crontab]# php main.php -h

  帮助信息:
  Usage: /path/to/php main.php [options] -- [args...]

  -h [--help]        显示帮助信息
  -p [--pid]         指定pid文件位置(默认pid文件保存在当前目录)
  -s start           启动进程
  -s stop            停止进程
  -s restart         重启进程
  -l [--log]         log文件夹的位置
  -c [--config]      config文件的位置
  -d [--daemon]      是否后台运行
  -r [--reload]      重新载入配置文件
  -m [--monitor]     监控进程是否在运行,如果在运行则不管,未运行则启动进程
  --worker           开启worker
  --tasktype         task任务获取类型,[file|mysql] 默认是file
  --checktime        默认精确对时(如果精确对时,程序则会延时到分钟开始0秒启动) 值为false则不精确对时

47行：self::params_d($opt);//设置常量，Crontab::$daemon = true; 设置为守护进程

48行：self::params_p($opt);//设置pid文件的位置 ，如果-p不接入参数会默认保存在当前目录

        if (empty(Crontab::$pid_file)) {
            Crontab::$pid_file = ROOT_PATH . "/pid";
        }

49行：self::params_l($opt);//设置日志文件放置位置，如果-l不写参数会默认保存在当前目录的logs文件夹

50行：self::params_c($opt);//设置config配置参数这里的配置参数太过于复杂，我也不认为有人会想输入这个参数，这里默认值是根目录下的config/crontab.php中

<?php
return array(
    'taskid1' =>
        array(
            'taskname' => 'php -i',  //任务名称
            'rule' => '* * * * * *',//定时规则
            "unique" => 1, //排他数量，如果已经有这么多任务在执行，即使到了下一次执行时间，也不执行
            'execute'  => 'Cmd',//命令处理类
            'args' =>
                array(
                    'cmd'    => 'php -i',//命令
                    'ext' => '',//附加属性
                ),
        ),
    'taskid2' =>
        array(
            'taskname' => 'test',  //任务名称
            'rule' => array("09:30","14:12:58","22:30:36","22:24:36"),
            "unique" => 1, //排他数量，如果已经有这么多任务在执行，即使到了下一次执行时间，也不执行
            "execute" =>"Gather",
            'args' =>
                array(
                    'cmd'    => 'gather',//命令
                    'ext' => '',//附加属性
                ),
        ),
);　　

　这里是配置任务的相关参数，注意这里有几个需要注意的，execute是需要执行的命令，unique排他数量，rule是规则

　行51：self::params_r($opt);

　这里会重新载入配置文件，会判断之前的pid文件是否存在，如果存在就会执行kill

　　swoole_process::kill($pid, 0)这句话是指的 $signo=0，可以检测进程是否存在，不会发送信号（swoole文档里面有说明，附传送门：https://wiki.swoole.com/wiki/page/219.html）

　　发送SIGUSR1命令 ，但是我再后面的测试过程中发现，这个指令并没有什么用，不即时

static public function params_r($opt)
    {
        if (isset($opt["r"]) || isset($opt["reload"])) {
            $pid = @file_get_contents(Crontab::$pid_file);
            if ($pid) {
                if (swoole_process::kill($pid, 0)) {
                    swoole_process::kill($pid, SIGUSR1);
                    Main::log_write("对 {$pid} 发送了从新载入配置文件的信号");
                    exit;
                }
            }
            Main::log_write("进程" . $pid . "不存在");
        }
    }　　

行52：self::params_worker($opt);Crontab::$worker = true;具体功能：设置开启工作进程，解释是：工厂要生成很多商品，将不同的商品流水线交给不同的工人进行生产处理

行53：self::params_tasktype($opt);//task任务获取类型,[file|mysql] 默认是file 这里其实看源码最起码从main.php是看不到此类限制，但是在include/loadtask/LoadTasks.class.php里面的构造方法里面有这种判断

行54：self::params_checktime($opt);//Crontab::$checktime = false;

行55：$opt = self::params_m($opt);//源码里面很清楚，检测进程是否存在，如果存在则重新设置参数数组，标示重启执行-s restart

行56：self::params_s($opt);//这里是核心方法，下节开始分析