Cron & CLIالمهام والأوامر.

# الطريقة الرسمية — Magento بيكتبه بنفسه
bin/magento cron:install

# شوف اللي اتكتب
crontab -l

# الشكل المتوقّع تقريباً:
# * * * * * /usr/bin/php /var/www/bin/magento cron:run

-- توزيع الحالات في آخر ساعة
SELECT status, COUNT(*)
FROM cron_schedule
WHERE scheduled_at > NOW() - INTERVAL 1 HOUR
GROUP BY status;

-- آخر المهام الناجحة — هل الـ cron حي؟
SELECT job_code, executed_at
FROM cron_schedule
WHERE status = 'success'
ORDER BY executed_at DESC LIMIT 10;

-- الأخطاء بأسبابها
SELECT job_code, messages, scheduled_at
FROM cron_schedule
WHERE status = 'error'
ORDER BY scheduled_at DESC LIMIT 20;

-- مهام عالقة في running
SELECT job_code, executed_at
FROM cron_schedule
WHERE status = 'running'
  AND executed_at < NOW() - INTERVAL 1 HOUR;

<?xml version="1.0"?>
<config>
  <group id="default">

    <!-- جدولة ثابتة -->
    <job name="vendor_cleanup_old_data"
      instance="Vendor\Module\Cron\CleanupOldData"
      method="execute">
      <!-- كل يوم 3 صباحاً -->
      <schedule>0 3 * * *</schedule>
    </job>

    <!-- جدولة من الإعدادات — الأفضل -->
    <job name="vendor_sync_erp"
      instance="Vendor\Module\Cron\SyncErp"
      method="execute">
      <config_path>vendor/sync/schedule</config_path>
    </job>

  </group>
</config>

*/15 * * * *    # كل 15 دقيقة
0 * * * *       # كل ساعة في الدقيقة صفر
0 3 * * *       # كل يوم 3 صباحاً
0 3 * * 1       # كل إثنين 3 صباحاً
0 0 1 * *       # أول كل شهر
*/5 9-17 * * 1-5 # كل 5 دقايق، أيام العمل بس

namespace Vendor\Module\Cron;

use Psr\Log\LoggerInterface;
use Magento\Framework\App\Config\ScopeConfigInterface;

class SyncErp
{
    private const ENABLED_PATH = 'vendor/sync/enabled';

    public function __construct(
        private readonly ScopeConfigInterface $config,
        private readonly SyncService $service,
        private readonly LoggerInterface $logger
    ) {}

    public function execute(): void
    {
        // 1. مفتاح تعطيل — مهم جداً
        if (!$this->config->isSetFlag(self::ENABLED_PATH)) {
            return;
        }

        $start = microtime(true);

        try {
            $count = $this->service->sync();

            // 2. سجّل النجاح بأرقام مفيدة
            $this->logger->info('ERP sync done', [
                'records'  => $count,
                'duration' => round(microtime(true) - $start, 2),
            ]);

        } catch (\Exception $e) {
            // 3. سجّل وارمي — عشان تتعلّم error
            $this->logger->error('ERP sync failed', [
                'error' => $e->getMessage(),
            ]);
            throw $e;
        }
    }
}

# شغّل يدوياً وشوف المخرجات
bin/magento cron:run

# مجموعة محددة
bin/magento cron:run --group=index

# هل فيه عمليات cron شغّالة؟
ps aux | grep cron:run

# أخطاء الـ cron في السجلات
grep -i cron var/log/system.log | tail -30

-- شوف الأول قبل ما تعدّل
SELECT * FROM cron_schedule
WHERE status = 'running'
  AND executed_at < NOW() - INTERVAL 2 HOUR;

-- بعد التأكد إن مفيش عملية شغّالة فعلاً
UPDATE cron_schedule
SET status = 'error',
    messages = 'Manually cleared - stuck'
WHERE status = 'running'
  AND executed_at < NOW() - INTERVAL 2 HOUR;

SELECT COUNT(*) AS total,
       MIN(scheduled_at) AS oldest
FROM cron_schedule;

-- لو الأقدم من شهور، التنظيف مش شغّال

bin/magento cache:status
bin/magento cache:clean config layout block_html
bin/magento cache:flush

bin/magento indexer:status
bin/magento indexer:reindex
bin/magento indexer:set-mode schedule

bin/magento module:status
bin/magento module:enable Vendor_Module
bin/magento module:disable Vendor_Module

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f ar_SA en_US

# اقرا إعداد
bin/magento config:show web/secure/base_url

# غيّر إعداد
bin/magento config:set web/secure/use_in_frontend 1

# إعداد حسّاس — بيتشفّر
bin/magento config:set:sensitive payment/gateway/key VALUE

bin/magento deploy:mode:show
bin/magento deploy:mode:set production

bin/magento maintenance:enable
bin/magento maintenance:enable --ip=1.2.3.4
bin/magento maintenance:disable

bin/magento queue:consumers:list
bin/magento queue:consumers:start NAME --max-messages=100

bin/magento admin:user:create
bin/magento admin:user:unlock USERNAME
bin/magento info:adminuri

<type name="Magento\Framework\Console\CommandList">
  <arguments>
    <argument name="commands" xsi:type="array">
      <item name="vendorSyncProducts" xsi:type="object">
        Vendor\Module\Console\Command\SyncProducts
      </item>
    </argument>
  </arguments>
</type>

namespace Vendor\Module\Console\Command;

use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

class SyncProducts extends Command
{
    public function __construct(
        private readonly SyncService $service,
        $name = null
    ) {
        parent::__construct($name);
    }

    // اسم الأمر ووصفه
    protected function configure(): void
    {
        $this->setName('vendor:sync:products');
        $this->setDescription('Sync products from ERP');

        parent::configure();
    }

    // المنطق
    protected function execute(
        InputInterface $input,
        OutputInterface $output
    ): int {
        try {
            $count = $this->service->sync();

            $output->writeln(
                "<info>Synced {$count} products</info>"
            );

            // 0 = نجاح
            return Command::SUCCESS;

        } catch (\Exception $e) {
            $output->writeln(
                "<error>{$e->getMessage()}</error>"
            );

            // غير صفر = فشل
            return Command::FAILURE;
        }
    }
}

bin/magento setup:upgrade
bin/magento cache:clean

# شوفه في القائمة
bin/magento list | grep vendor

# شغّله
bin/magento vendor:sync:products

use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputOption;

protected function configure(): void
{
    $this->setName('vendor:sync:products');

    // مُدخل إجباري
    $this->addArgument(
        'source',
        InputArgument::REQUIRED,
        'Source system code'
    );

    // خيار بقيمة
    $this->addOption(
        'limit', 'l',
        InputOption::VALUE_OPTIONAL,
        'Max records',
        100  // القيمة الافتراضية
    );

    // خيار بدون قيمة — علم
    $this->addOption(
        'dry-run', null,
        InputOption::VALUE_NONE,
        'Preview without saving'
    );

    parent::configure();
}

protected function execute(
    InputInterface $input,
    OutputInterface $output
): int {
    $source = $input->getArgument('source');
    $limit  = (int) $input->getOption('limit');
    $dryRun = (bool) $input->getOption('dry-run');

    if ($dryRun) {
        $output->writeln(
            '<comment>Dry run — nothing saved</comment>'
        );
    }

    $records = $this->service->fetch($source, $limit);

    // شريط تقدّم — مفيد للعمليات الطويلة
    $progress = new ProgressBar($output, count($records));
    $progress->start();

    foreach ($records as $record) {
        if (!$dryRun) {
            $this->service->save($record);
        }
        $progress->advance();
    }

    $progress->finish();
    $output->writeln('');

    return Command::SUCCESS;
}

bin/magento vendor:sync:products erp
bin/magento vendor:sync:products erp --limit=500
bin/magento vendor:sync:products erp --dry-run