Download the PHP package mftsoft/schedule without Composer
On this page you can find all versions of the php package mftsoft/schedule. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package schedule
Schedule Framework
Uma biblioteca PHP robusta e desacoplada para gerenciamento e execução de tarefas assíncronas (Cron Jobs). O Schedule facilita a orquestração de rotinas, garantindo controle de concorrência, execução baseada em expressões Cron padrão e logs centralizados.
Funcionalidades
- Expressões Cron Padrão: Integração com
dragonmantank/cron-expressionpara flexibilidade na definição de agendamentos (* * * * *). - Prevenção de Concorrência: Uso de locks exclusivos (
flock) e tracking de execuções (.last_run) para garantir que uma mesma tarefa não atropele outra execução idêntica em andamento. - Isolamento e Logs: Captura de exceções por tarefa sem interromper a fila principal, medindo a duração da execução e guardando o histórico no arquivo
logs/scheduler.log. - Factory Simplificada: Execução das tarefas abstraída em uma interface limpa, onde o projeto cliente apenas injeta as suas regras de negócio.
Requisitos
- PHP >= 8.1
- Composer
Instalação
Você pode incluir este projeto no seu aplicativo usando o Composer:
Como Usar
1. Criando uma Tarefa (Task)
Crie as suas tarefas estendendo a classe abstrata Schedule\Core\AbstractTask. Você deve implementar três métodos obrigatórios:
2. Ponto de Entrada Padrão (Sem Frameworks)
Para projetos em PHP puro, crie um script (ex: cron.php) na raiz do projeto que será chamado pelo crontab a cada minuto. Utilize a TaskFactory para registrar e orquestrar suas tasks:
3. Integração com Mad Builder / Adianti Framework (cmd.php)
Dentro de um projeto gerado pelo Mad Builder utilizando o Adianti Framework, a recomendação é utilizar o script cmd.php (na raiz do projeto) como ponto de entrada do Scheduler.
Como o script cmd.php já existe nativamente no Adianti e carrega toda a aplicação, você não precisa modificá-lo! Basta criar uma Classe de Serviço no seu projeto para abrigar a chamada ao Scheduler.
Exemplo de serviço (ex: app/service/task/SchedulerService.php):
4. Configurando a Execução Automática (Sistema Operacional)
O Scheduler funciona verificando minuto a minuto quais tarefas devem rodar. Por isso, você deve configurar o seu sistema operacional para chamar o comando do Adianti a cada minuto. O framework Adianti exige a passagem dos parâmetros class e method.
🐧 Linux (Cron)
Adicione a linha abaixo no Crontab (crontab -e):
🪟 Windows (Agendador de Tarefas / Task Scheduler)
No Windows, configure uma tarefa que se repita continuamente:
- Abra o aplicativo Agendador de Tarefas e selecione Criar Tarefa....
- Na aba Geral, defina um nome (ex:
Adianti Scheduler). - Na aba Disparadores, clique em Novo. Configure como Diariamente, marque a opção Repetir a tarefa a cada:
1 minuto, com duração de Indefinidamente. - Na aba Ações, clique em Novo:
- Ação: Iniciar um programa.
- Programa/script:
php(ou o caminho completo, ex:C:\php\php.exe). - Adicionar argumentos:
-f "C:\caminho\do\projeto\cmd.php" "class=SchedulerService&method=run" - Iniciar em:
C:\caminho\do\projeto\
- Salve e o agendamento iniciará.
Testes
Este projeto utiliza o PHPUnit para cobertura de código. Para rodar a suíte de testes unitários:
