bentools/crontab-bundle

Generates a crontab based on the app directory.

Crontab Bundle

An easy way to generate a crontab based on the application path., _(*1)

Unlike similar Symfony bundles, this one does not provide a worker, it actually replaces the user's crontab., _(*2)

⚠️ Do not use this if your user's crontab may by altered by another process!, _(*3)

[!IMPORTANT]
This repository is no longer maintained and may be removed in a near future. You may consider creating a fork if you still require it., _(*4)

Installation

This bundle is compatible with Symfony 4/5+. Use 0.1.* tag for earlier versions compatibility., _(*5)

composer require bentools/crontab-bundle 0.2.*

With Symfony Flex, you're already done!, _(*6)

Usage

Create a sample crontab in config/crontab.dist:, _(*7)

# config/crontab.dist

0 0 * * * php {%kernel.project_dir%}/bin/console your:favorite:command

As you can see, {%kernel.project_dir%} is a container parameter. It will be replaced at runtime with its current value. You can use any container parameter wrapped with curly braces., _(*8)

Preview

This will give you a preview of your crontab:, _(*9)

php bin/console crontab:update --dry-run --dump

Apply

To apply your crontab, run this:, _(*10)

php bin/console crontab:update

Now if you execute crontab -l in your shell you should see something like this:, _(*11)

0 0 * * * php /home/me/my-project/bin/console your:favorite:command

FAQ

Can I use any container parameter?

Yes., _(*12)

I don't want the dist file to be config/crontab.dist. Can I change that?

Sure: create a config/packages/bentools_crontab.yaml and change the dist_file parameter:, _(*13)

bentools_crontab:
    dist_file: '%env(CRONTAB_SAMPLE_FILE)%' # That's an example.

What are the command options?

--no-interaction # Skip confirmation question
--dry-run # Do not update crontab for real
--output-file=/path/to/generated_crontab # Change output file (which is a tmp file by default)
--dump # Show generated crontab content

I already have a crontab for the user running my app. Will it replace it?

Yes. Use this bundle only if you consider it to be the only crontab entry point., _(*14)

Tests

./vendor/bin/pest

License

MIT, _(*15)