إنشاء السايت ماب برمجياً: دليل عملي بلغة Python وPHP وNext.js
إنشاء السايت ماب برمجياً يعني كتابة سكربت يقرأ روابط موقعك من قاعدة البيانات ويحوّلها تلقائياً إلى ملف XML صالح لمحركات البحث، بدلاً من تحديث الملف يدوياً أو الاعتماد على أداة خارجية. وهذا الأسلوب هو الأنسب للمتاجر والمواقع الكبيرة والمنصات المبنية خصيصاً، لأن الخريطة تبقى مطابقة لما هو منشور فعلاً في كل وقت.
إذا كان موقعك يعمل على ووردبريس أو منصة جاهزة فغالباً لا تحتاج إلى كل هذا، ويكفيك ما شرحناه في دليل إنشاء ملف خريطة الموقع وإرساله إلى Google. أما هذا المقال فموجّه للمطورين ومختصي السيو التقني الذين يريدون بناء الخريطة بالكود، مع أمثلة جاهزة بلغة Python وPHP وإطار Next.js.
أهم النقاط باختصار
- يقبل الملف الواحد 50,000 رابط أو 50 ميغابايت قبل الضغط، وما زاد عن ذلك يُقسَّم إلى عدة ملفات.
- يجب أن يكون الملف بترميز UTF-8، وأن تكون الروابط كاملة وقانونية، وأن تُهرَّب الرموز الخاصة في القيم.
- تتجاهل Google وسمي priority وchangefreq، وتستخدم lastmod فقط إذا كان دقيقاً باستمرار.
- ابنِ الخريطة من مصدر البيانات نفسه، واستبعد الصفحات المحذوفة والمحوّلة وغير القابلة للفهرسة.
- أعلن عن الخريطة في robots.txt وأرسلها عبر Search Console، مع تذكّر أن الإرسال مجرد إشارة وليس ضماناً للزحف.
متى تحتاج إلى إنشاء السايت ماب برمجياً؟
تتغير صفحات المواقع الديناميكية باستمرار: منتجات تُضاف، وعروض تنتهي، ومقالات تُحدَّث. وفي هذه الحالة يصبح الملف الثابت قديماً بسرعة، فيحتوي على روابط ميتة ويغفل صفحات جديدة. ولفهم الدور الأساسي للملف وأنواعه يمكنك الرجوع إلى مقال أهمية خريطة الموقع، أما الحل البرمجي فيصبح منطقياً عندما ينطبق على موقعك واحد أو أكثر مما يلي:
- موقع مبني بإطار عمل أو نظام خاص لا يوفر خريطة جاهزة.
- متجر أو دليل يضم عدداً كبيراً من الصفحات التي تتغير يومياً.
- حاجة إلى قواعد دقيقة تحدد ما يدخل الخريطة، مثل استبعاد المنتجات غير المتوفرة نهائياً.
- رغبة في تقسيم الروابط حسب القسم لمتابعة الفهرسة بدقة في Search Console.
وتزداد أهمية ذلك في المواقع الضخمة التي تهتم بإدارة ميزانية الزحف، لأن خريطة نظيفة تساعد Google على اكتشاف الروابط المهمة بدلاً من إهدار الزحف على روابط لا قيمة لها.
المتطلبات التقنية لملف السايت ماب
قبل كتابة أي كود، يجب أن يلتزم المخرج بالقواعد التالية، فأي خلل فيها قد يؤدي إلى رفض الملف أو تجاهل جزء منه:
| العنصر | المطلوب | ملاحظة تطبيقية |
|---|---|---|
| الحد الأقصى | 50,000 رابط أو 50 ميغابايت غير مضغوط | قسّم الملف واستخدم ملف فهرس |
| الترميز | UTF-8 | اضبطه صراحة عند كتابة الملف |
| الروابط | كاملة مع البروتوكول والنطاق | لا تستخدم المسارات النسبية |
| نوع الروابط | القانونية فقط | طابقها مع وسم canonical |
| الرموز الخاصة | تهريب القيم | مثل تحويل & داخل الروابط |
| lastmod | تاريخ آخر تعديل مهم | بصيغة W3C مثل سنة وشهر ويوم |
| priority وchangefreq | تتجاهلهما Google | يمكن حذفهما لتقليل الحجم |
ولأن الخريطة يجب أن تعكس النسخة المعتمدة من كل صفحة، راجع منطق الكانونيكال تاغ في موقعك قبل البدء، حتى لا يعلن الملف عن رابط بينما تشير الصفحة نفسها إلى رابط آخر.
خطوات إنشاء السايت ماب برمجياً
هذه هي المراحل التي تنطبق على أي لغة برمجة، وبعدها ستجد التطبيق العملي بالكود.
1. حدد مصدر الروابط
اكتب استعلاماً يجلب الصفحات المنشورة من قاعدة البيانات أو نظام إدارة المحتوى، مع حقل تاريخ آخر تعديل، حتى يكون المصدر هو البيانات الحقيقية لا عملية زحف خارجية.
2. طبّق شروط الاستبعاد
استبعد الصفحات التي تحمل noindex، والصفحات المحذوفة أو المحوّلة، والروابط غير القانونية، بحيث لا يبقى في القائمة إلا ما تريد ظهوره في نتائج البحث.
3. ولّد ملف XML بصيغة صحيحة
أنشئ عنصر urlset مع مساحة الأسماء المعتمدة، وأضف لكل صفحة عنصر url يضم loc وlastmod، مع تهريب القيم وترميز الروابط العربية.
4. قسّم الروابط وأنشئ ملف الفهرس
إذا تجاوزت الروابط الحد المسموح، وزّعها على عدة ملفات حسب العدد أو القسم، ثم أنشئ ملف فهرس يشير إلى جميع هذه الملفات.
5. حدّث الملف تلقائياً
شغّل السكربت بمهمة مجدولة أو عند نشر المحتوى، أو ولّد الملف عند الطلب مع التخزين المؤقت، حتى تبقى الخريطة مطابقة للموقع دون تدخل يدوي.
6. أعلن عن الخريطة وراقبها
أضف رابطها إلى robots.txt، وأرسلها من تقرير خرائط المواقع في Search Console، ثم تابع الأخطاء وعدد الصفحات المكتشفة بعد كل تغيير كبير.
مثال عملي بلغة Python
يستخدم هذا السكربت مكتبات Python القياسية فقط، ويقسّم الروابط تلقائياً وينشئ ملف الفهرس. استبدل الدالة fetch_pages باستعلام قاعدة بياناتك:
from pathlib import Path
from urllib.parse import quote
from xml.sax.saxutils import escape
BASE = "https://example.com"
NS = "http://www.sitemaps.org/schemas/sitemap/0.9"
LIMIT = 50000
HEAD = '<?xml version="1.0" encoding="UTF-8"?>'
def fetch_pages():
# SELECT path, updated_at FROM pages
# WHERE status = 'published' AND noindex = 0
return [("/products/عطر-العود", "2026-01-15")]
def write_sitemap(name, rows):
lines = [HEAD, f'<urlset xmlns="{NS}">']
for path, updated in rows:
loc = escape(BASE + quote(path))
lines.append(f"<url><loc>{loc}</loc>"
f"<lastmod>{updated}</lastmod></url>")
lines.append("</urlset>")
Path(name).write_text("\n".join(lines), encoding="utf-8")
def build():
rows = fetch_pages()
names = []
for i in range(0, len(rows), LIMIT):
name = f"sitemap-{i // LIMIT}.xml"
write_sitemap(name, rows[i:i + LIMIT])
names.append(name)
items = "".join(
f"<sitemap><loc>{BASE}/{n}</loc></sitemap>" for n in names)
Path("sitemap.xml").write_text(
f'{HEAD}<sitemapindex xmlns="{NS}">{items}</sitemapindex>',
encoding="utf-8")
build()
لاحظ أن الدالة quote تحوّل المسارات العربية إلى صيغة مرمّزة آمنة، وأن escape تعالج الرموز الخاصة. وهاتان النقطتان من أكثر ما يُغفل في المواقع العربية، فيظهر الخطأ عند قراءة الملف رغم أن الروابط تعمل في المتصفح.
مثال عملي بلغة PHP
يناسب هذا الأسلوب المواقع المبنية بلغة PHP، إذ يولّد الخريطة عند الطلب من ملف واحد. وفي المواقع الكبيرة أضف طبقة تخزين مؤقت حتى لا يتكرر الاستعلام مع كل زيارة من الزواحف:
<?php
header('Content-Type: application/xml; charset=UTF-8');
$pdo = new PDO($dsn, $user, $pass);
$sql = "SELECT path, updated_at FROM pages
WHERE status = 'published' AND noindex = 0
LIMIT 50000";
$xml = new XMLWriter();
$xml->openURI('php://output');
$xml->startDocument('1.0', 'UTF-8');
$xml->startElement('urlset');
$xml->writeAttribute('xmlns',
'http://www.sitemaps.org/schemas/sitemap/0.9');
foreach ($pdo->query($sql) as $row) {
$path = implode('/', array_map('rawurlencode',
explode('/', $row['path'])));
$xml->startElement('url');
$xml->writeElement('loc', 'https://example.com' . $path);
$xml->writeElement('lastmod',
date('Y-m-d', strtotime($row['updated_at'])));
$xml->endElement();
}
$xml->endElement();
$xml->endDocument();
تتولى XMLWriter تهريب القيم تلقائياً، وهذا أكثر أماناً من تجميع النصوص يدوياً. وإذا كان عدد صفحاتك يقترب من الحد الأقصى، فأضف معامل صفحة إلى الرابط واستخدم OFFSET لتقسيم النتائج على عدة ملفات.
إنشاء السايت ماب في Next.js
يوفر Next.js ملف sitemap.ts داخل مجلد app، ويعيد مصفوفة من الروابط ليولّد منها sitemap.xml في جذر الموقع. وللمواقع الكبيرة تتيح الدالة generateSitemaps إنشاء عدة ملفات بروابط مثل /product/sitemap/1.xml:
// app/product/sitemap.ts
import type { MetadataRoute } from 'next'
import { countProducts, getProducts } from '@/lib/products'
const LIMIT = 50000
export async function generateSitemaps() {
const total = await countProducts()
const pages = Math.ceil(total / LIMIT)
return Array.from({ length: pages }, (_, id) => ({ id }))
}
export default async function sitemap(props: {
id: Promise<string>
}): Promise<MetadataRoute.Sitemap> {
const id = Number(await props.id)
const products = await getProducts(id * LIMIT, LIMIT)
return products.map((p) => ({
url: `https://example.com/product/${p.slug}`,
lastModified: p.updatedAt,
}))
}
هذا الشكل يطابق توثيق الإصدار السادس عشر، حيث يصل المعرّف id كوعد نصي. أما في الإصدار الخامس عشر فيصل رقماً مباشرة، لذا راجع إصدار مشروعك قبل النسخ. ويُخزَّن الناتج مؤقتاً افتراضياً ما لم تستخدم واجهات ديناميكية أو إعدادات تجعله ديناميكياً.
أخطاء شائعة عند توليد الخريطة بالكود
- جعل lastmod مساوياً لوقت التشغيل: كتابة التاريخ الحالي لكل الروابط تفقد الوسم مصداقيته. استخدم تاريخ آخر تعديل مهم للمحتوى فقط.
- تضمين روابط محوّلة أو محذوفة: اربط الاستعلام بحالة الصفحة، وعالج عمليات إعادة التوجيه وصفحات 404 حتى لا تظهر في الملف.
- الاعتماد على الخريطة وحدها: وجود الرابط في الملف لا يعوض ضعف الربط الداخلي، لذا افحص الصفحات اليتيمة بانتظام.
- وضع الملف في مجلد فرعي دون إرساله: إذا لم يُرسل عبر Search Console فإن تأثيره يقتصر على الصفحات التابعة لمجلده، لذا يُفضَّل وضعه في الجذر.
- توقع فهرسة فورية: قد تبقى صفحات مدرجة في الخريطة دون فهرسة، وفي هذه الحالة راجع حالة تم اكتشاف الصفحة ولكن لم تتم فهرستها.
كيف ترسل الخريطة إلى Google؟
أضف إلى ملف robots.txt سطراً واحداً بهذا الشكل، ويمكنك تكراره لأي عدد من الخرائط:
Sitemap: https://example.com/sitemap.xml
ثم أرسل رابط الملف من تقرير خرائط المواقع في Search Console، أو استخدم واجهة Search Console API إذا كنت تدير عدداً كبيراً من المواقع وتريد أتمتة الإرسال ضمن عملية النشر. وبعد الإرسال راقب عدد الروابط المكتشفة، وقارنه بعدد الصفحات التي يعيدها استعلامك للتأكد من سلامة التوليد.
الأسئلة الشائعة
هل إنشاء السايت ماب برمجياً أفضل من الإضافات؟
ليس دائماً. الإضافات كافية لمعظم مواقع ووردبريس، أما الحل البرمجي فيناسب المواقع المخصصة والكبيرة التي تحتاج إلى قواعد دقيقة لاختيار الروابط وتقسيمها.
كم عدد الروابط المسموح به في الملف الواحد؟
يصل الحد إلى 50,000 رابط أو 50 ميغابايت قبل الضغط لكل ملف. وعند تجاوز أحدهما قسّم الروابط على عدة ملفات واجمعها في ملف فهرس.
هل يجب إضافة priority وchangefreq إلى الملف؟
لا حاجة إليهما عند استهداف Google لأنها تتجاهل القيمتين. ركز بدلاً من ذلك على صحة الروابط ودقة تاريخ آخر تعديل.
كم مرة يجب تحديث السايت ماب؟
لا يوجد جدول ثابت، والمهم أن يتغير الملف عند تغير المحتوى. لذلك يناسب المواقع النشطة التوليد عند النشر أو عبر مهمة مجدولة متكررة.
هل تضمن الخريطة فهرسة جميع الصفحات؟
لا. فإرسال الخريطة إشارة تساعد Google على اكتشاف الروابط، لكنها لا تضمن زحفها أو فهرستها، إذ يبقى القرار مرتبطاً بجودة الصفحات وعوامل أخرى.
الخلاصة
إنشاء السايت ماب برمجياً استثمار صغير يمنحك خريطة دقيقة تتحدث مع موقعك دون جهد يدوي. ابدأ باستعلام نظيف يجلب الصفحات القابلة للفهرسة فقط، والتزم بالحدود والترميز، واجعل lastmod صادقاً، ثم أعلن عن الملف في robots.txt وتابعه في Search Console. وبعد أول تشغيل، قارن النتائج بما تتوقعه قبل اعتماد العملية بشكل دائم.
المصادر
- Google Search Central: Build and submit a sitemap
- Next.js: generateSitemaps
- Next.js: sitemap.xml file convention
- Search Engine Land: XML sitemaps and SEO
- Specification.website: XML sitemaps

