Cron

The cron launcher (Launcher.php) parses the arguments and instances the Cron Manager. The Launcher.php is located under src/main/php/Tools/Cron/.

Arguments

• The class or classes that will be croned.
• config(c): Optional. The process file configuration (this will load the process config so make sure it's correctly configured, and other settings).

In the configuration process file you can customize the cron's settings like manager and process logger, the config folder, the data folder, the process pid, the bootstrap class and bootstrap's resources.

Example

Let's assume we have the cron TestProject_Cron_Everyday:

We need to do:

php -f Launcher.php -- TestProject_Cron_Everyday

And if we want to run more than one cron at same time, we just do:

php -f Launcher.php -- TestProject_Cron_Everyday TestProject_Cron_EverydayToo

This will use the default manager.xml and process.xml located on src/main/resources/config

If we want use a costumized manager.xml we simply do:

php -f Launcher.php -- -c ~/testproject/src/main/php/resources/config/manager.xml TestProject_Cron_Everyday

If we need to pass some arguments to the cron we only have to add to the command something like "key=value", for example:

php -f Launcher.php -- -c ~/testproject/src/main/php/resources/config/manager.xml TestProject_Cron_Everyday mail="[email protected]"

Customizing the manager.xml

Global:

• zend-config.manager.processNamespace: the process namespace.
• zend-config.manager.logPath: the path where the logs will be saved.

For process:

• zend-config.process.data.dir: the data's folder.
• zend-config.process.configDir: the process config folder.
• zend-config.process.logPath: the process log folder.
• zend-config.process.pid.path: the pid folder.
• zend-config.process.pid.file: the pid filename.
• zend-config.process.outputFile: the output file.
• zend-config.process.app.bootstrap.class: the bootstrap's class name,
• zend-config.process.app.bootstrap.path: the bootstrap's filename.
• zend-config.process.app.bootstrap.resources: the bootstrap resources that the process will need. If a process need some service/module which require to be properly initialized, we put the function located in bootstrap for that purpose.

For loggin: the logger configuration has to be aproppiate for the writer used. This configuration has to be on zend-config.manager.log.

• zend-config.manager.log.writerName: the writer name.
• zend-config.manager.log.writerNamespace: the writer namespace.

Examples of logger configurations:

For file logger:

• zend-config.manager.log.fileLogger.writerParams.stream: the stream's name.
• zend-config.manager.log.fileLogger.writerName: the writer's name.
• zend-config.manager.log.fileLogger.writerNamespace: the writer's.

For mail logger:

• zend-config.manager.log.mailLogger.writerName: the writer's name.
• zend-config.manager.log.mailLogger.writerNamespace: the writers
• zend-config.manager.log.mailLogger.writerParams.to: the receiver's mail.
• zend-config.manager.log.mailLogger.writerParams.from: the sender's mail.
• zend-config.manager.log.mailLogger.writerParams.subject: the mail's subject.
• zend-config.manager.log.mailLogger.writerParams.transport: the mail's transport.
• zend-config.manager.log.mailLogger.writerParams.host: the host.
• zend-config.manager.log.mailLogger.writerParams.config: all the configuration data necessary.

For SMTP mail logger:

• zend-config.manager.log.mailLogger.writerParams.config.name: the name.
• zend-config.manager.log.mailLogger.writerParams.config.port: the port.
• zend-config.manager.log.mailLogger.writerParams.config.ssl: only if is required.
• zend-config.manager.log.mailLogger.writerParams.config.auth: ony if is required.
• zend-config.manager.log.mailLogger.writerParams.config.username: the username.
• zend-config.manager.log.mailLogger.writerParams.config.password: the password.

For example:

<zend-config>
    <manager>
        <fileLogger>
            <writerParams>
                <stream>manager.log</stream>
            </writerParams>
            <writerName>LazyStream</writerName>
            <writerNamespace>ZendExt_Log_Writer</writerNamespace>
         </fileLogger>
        <mailLogger>
            <writerName>Mail</writerName>
            <writerNamespace>ZendExt_Log_Writer</writerNamespace>
            <filterName>Priority</filterName>
            <filterParams>
                <operator><![CDATA[<=]]></operator>
                <priority>2</priority>
            </filterParams>
            <writerParams>
                <to>[email protected]</to>
                <from>[email protected]</from>
                <subject>Subject!</subject>
                <transport>smtp</transport>
                <host>smtp.example.com</host>
               <config>
                    <name>example.com</name>
                    <port>587</port>
                    <ssl>tls</ssl>
                    <auth>login</auth>
                        <username>[email protected]</username>
                    <password>password</password>
                </config>
            </writerParams>
        </mailLogger>
    </manager>
    <process>
        <data>
            <dir>data/</dir>
        </data>
        <configDir>resources/config/processes</configDir>
        <logPath>log/</logPath>
        <log>
            <fileLogger>
                <writerParams>
                    <stream>process.log</stream>
                </writerParams>
                <writerName>LazyStream</writerName>
                <writerNamespace>ZendExt_Log_Writer</writerNamespace>
            </fileLogger>
        </log>
        <pid>
            <path>pid/</path>
            <file>process.pid</file>
        </pid>
        <outputFile>php://stdout</outputFile>
        <app>
            <bootstrap>
                <class>TestProject_Bootstrap</class>
                <path>TestProject/Bootstrap.php</path>
            </bootstrap>
            <resources>
                <Config />
                <DbInit/>
            </resources>
        </app>
    </process>
</zend-config>