mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-23 12:03:09 +02:00
Divarion-D
738973c5db
- Add @author, @copyright, @link, @version, @license to 399 PHP files - MERGE mode: inject metadata into 243 existing docblocks (preserving docs) - INSERT mode: create new docblocks for 156 files without headers - Skip 3 files that already had correct headers - Exclude third-party libs (TMDb, mobiledetect, Dropbox, etc.) - Exclude bin/, ministra/, content/, tmp/, resources/, module views - Update tools/add_headers.php to v2 with MERGE strategy
89 lines
2.8 KiB
PHP
89 lines
2.8 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Общий функционал для cron-задач.
|
|
*
|
|
* Выносит повторяющийся boilerplate: проверка пользователя, cron lock,
|
|
* shutdown handler (закрытие БД + удаление lock-файла).
|
|
*
|
|
* @package XC_VM_CLI
|
|
* @author Divarion_D <https://github.com/Divarion-D>
|
|
* @copyright 2025-2026 Vateron Media
|
|
* @link https://github.com/Vateron-Media/XC_VM
|
|
* @license AGPL-3.0 https://www.gnu.org/licenses/agpl-3.0.html
|
|
*/
|
|
|
|
trait CronTrait {
|
|
|
|
/** @var string|null Путь к lock-файлу */
|
|
protected $rIdentifier;
|
|
|
|
/**
|
|
* Проверить что процесс запущен от пользователя xc_vm.
|
|
*/
|
|
protected function assertRunAsXcVm(): bool {
|
|
if ((posix_getpwuid(posix_geteuid())['name'] ?? null) !== 'xc_vm') {
|
|
echo "Please run as XC_VM!\n";
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Проверить что процесс запущен от root.
|
|
*/
|
|
protected function assertRunAsRoot(): bool {
|
|
if ((posix_getpwuid(posix_geteuid())['name'] ?? null) !== 'root') {
|
|
echo "Please run as root!\n";
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Установить заголовок процесса + time limit.
|
|
*/
|
|
protected function setProcessTitle(string $rTitle): void {
|
|
set_time_limit(0);
|
|
cli_set_process_title($rTitle);
|
|
}
|
|
|
|
/**
|
|
* Получить cron lock (уникальный файл в CRONS_TMP_PATH).
|
|
* Если lock уже занят — выходит с кодом 0.
|
|
*/
|
|
protected function acquireCronLock(): void {
|
|
$this->rIdentifier = CRONS_TMP_PATH . md5(
|
|
Encryption::generateUniqueCode(SettingsManager::getAll()['live_streaming_pass']) . static::class
|
|
);
|
|
ProcessManager::acquireCronLock($this->rIdentifier);
|
|
}
|
|
|
|
/**
|
|
* Зарегистрировать shutdown handler: закрытие БД + удаление lock.
|
|
*/
|
|
protected function registerShutdown(): void {
|
|
$rIdentifier = &$this->rIdentifier;
|
|
register_shutdown_function(static function () use (&$rIdentifier) {
|
|
global $db;
|
|
if (isset($db) && is_object($db)) {
|
|
$db->close_mysql();
|
|
}
|
|
if (!empty($rIdentifier) && file_exists($rIdentifier)) {
|
|
@unlink($rIdentifier);
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Стандартная инициализация cron-задачи.
|
|
*
|
|
* @param string $rTitle Заголовок процесса (например 'XC_VM[Activity]')
|
|
*/
|
|
protected function initCron(string $rTitle): void {
|
|
$this->registerShutdown();
|
|
$this->setProcessTitle($rTitle);
|
|
$this->acquireCronLock();
|
|
}
|
|
}
|