PHP Luminova: Integration of Sitemap Generator Module for Non-Nova-Kit

Generating a sitemap for your website with Luminova Framework is straightforward. Follow these simple steps.

Open Command Line Interface (CLI): Navigate to your project directory in the command line interface and execute the following command in the CLI to generate the sitemap:

php novakit generate:sitemap

Configure Sitemap Settings (Required)

Customize your sitemap settings according to your project requirements. You will need to configure your project URL, optionally define your URL ignores or set the maximum scanning depth.

Configuration

Open the sitemap configuration file located at /app/Config/Sitemap.php, and modify the settings as needed.

After configuring your settings, rerun sitemap generation command (php novakit generate:sitemap) to apply the changes.

Sitemap Implementation

This example shows how to implement a custom sitemap generator in Luminova and schedule it to run periodically using cron jobs in production environments.

1 Implement Command Controller

The SitemapCommand class demonstrates how to generate a sitemap using Luminova's Sitemap generator.

// /app/Controllers/Cli/SitemapCommand.php

namespace App\Controllers\Cli;

use Luminova\Base\BaseCommand;
use Luminova\Seo\Sitemap;
use Exception;

class SitemapCommand extends BaseCommand
{
    /**
     * Generates the sitemap for the website.
     *
     * @return int Status code indicating success or failure.
     */
    public function generator(): int 
    {
        try {
            // Generate sitemap for the provided base URL
            if (Sitemap::generate(APP_URL, $this, 'sitemap.xml')) {
                echo 'Sitemap was successfully generated.';
                return STATS_SUCCESS; 
            }

            // If generation fails, display an error message
            echo 'Failed to generate sitemap.';
        } catch (Exception $e) {
            // Handle any unexpected exceptions
            echo 'Error generating sitemap: ' . $e->getMessage();
        }

        return STATS_ERROR;
    }
}

2 Cron Task Manager Configuration

The Cron configuration class schedules the SitemapCommand::generator method to run periodically.

// /app/Config/Cron.php

namespace App\Config;

use Luminova\Core\CoreCronTasks;

final class Cron extends CoreCronTasks
{
    /**
     * Schedules the task for periodic sitemap generation.
     */
    protected function schedule(): void 
    {
        // Schedule other service tasks...

        // Add a new task for generating the sitemap
        $this->service('\App\Controllers\Cli\SitemapCommand::generator')
            ->seconds(5) // Runs the task every 5 seconds (example; adjust as needed)
            ->output(root('/writeable/logs/') . 'cron.log') // Log output path
            ->log('debug'); // Debug-level logging
    }
}

3 Cron Job Scheduler

To run the sitemap generation task every 24 hours, configure a cron job on the server.

# Run the scheduled tasks in Luminova every 24 hours
0 0 * * * /usr/local/cpanel/3rdparty/bin/php /home/www/example.com/novakit cron:run >> /dev/null 2>&1

• Explanation:
  • 0 0 * * *: Schedule to run at midnight every day.
  • /usr/local/cpanel/3rdparty/bin/php: Path to PHP executable.
  • /home/www/example.com/novakit cron:run: Executes the Luminova cron task runner.
  • >> /dev/null 2>&1: Suppresses output and redirects errors to /dev/null.

Implementation Summary

1. Sitemap Generation: The SitemapCommand class handles sitemap creation for a specific website URL.
2. Task Scheduling: The Cron configuration ensures the sitemap generation is run automatically at defined intervals.
3. Server Cron Job: A server-side cron job executes Luminova's scheduled tasks at regular intervals.

Class Definition

• Class namespace: \Luminova\Seo\Sitemap

Methods

An alternative method to generate sitemap within your code.

generate

Generate am XML sitemap and store in in public directory.

public static generate(
    ?string $url = null, 
    \Luminova\Interface\LazyInterface $term = null, 
    string $basename = 'sitemap.xml'
): bool

Parameters:

Return:

• bool - Return true if successful, false otherwise.

Throws:

• Luminova\Exceptions\RuntimeException - If tries to call in none cli environment.