הגדרת מודול Migrate להעברת תוכן ב-Drupal

---
id: articles_from_csv
label: 'Статьи из CSV'
migration_group: content_import
source:
  plugin: csv
  path: 'public://import/articles.csv'
  ids:
    - external_id
  header_row_count: 1
  column_names:
    - external_id
    - title
    - body
    - category
    - publish_date
    - image_url
process:
  title: title
  'body/value': body
  'body/format':
    plugin: default_value
    default_value: full_html
  created:
    plugin: format_date
    source: publish_date
    from_format: 'd.m.Y'
    to_format: 'U'
  status:
    plugin: default_value
    default_value: 1
  field_category:
    plugin: migration_lookup
    migration: categories_from_csv
    source: category
  field_image:
    plugin: download
    source:
      - image_url
      - '@filename'
    destination:
      plugin: 'public://images'
    rename: true
destination:
  plugin: 'entity:node'
  default_bundle: article
migration_dependencies:
  required:
    - categories_from_csv
---

פיתוח תוסף מקור מותאם אישית ל-Drupal הוא פשוט. דוגמה לתוסף מקור מותאם אישית עבור API:

<?php

// src/Plugin/migrate/source/ExternalApiSource.php

namespace Drupal\mymodule\Plugin\migrate\source;

use Drupal\migrate\Plugin\migrate\source\SourcePluginBase;

/**
 * @MigrateSource(
 *   id = "external_api",
 *   source_module = "mymodule"
 * )
 */
class ExternalApiSource extends SourcePluginBase {

  public function getIds(): array {
    return ['id' => ['type' => 'integer']];
  }

  public function fields(): array {
    return [
      'id' => 'ID записи',
      'title' => 'Заголовок',
      'content' => 'Содержимое',
      'tags' => 'Теги (через запятую)',
    ];
  }

  protected function initializeIterator(): \Iterator {
    $page = 0;
    do {
      $response = \Drupal::httpClient()->get(
        'https://api.external.com/posts?page=' . $page,
        ['headers' => ['Authorization' => 'Bearer ' . $this->configuration['api_key']]]
      );
      $data = json_decode($response->getBody(), true);
      $items = $data['items'];
      foreach ($items as $item) {
        yield $item;
      }
      $page++;
    } while (!empty($items) && $page < $data['total_pages']);
  }

}

מניעת כפילויות בעת הרצה חוזרת של הגירה

השתמשו בסימן מים גבוה (highwater mark) או ב-id: articles_from_csv label: 'Статьи из CSV' migration_group: content_import source: plugin: csv path: 'public://import/articles.csv' ids: - external_id header_row_count: 1 column_names: - external_id - title - body - category - publish_date - image_url process: title: title 'body/value': body 'body/format': plugin: default_value default_value: full_html created: plugin: format_date source: publish_date from_format: 'd.m.Y' to_format: 'U' status: plugin: default_value default_value: 1 field_category: plugin: migration_lookup migration: categories_from_csv source: category field_image: plugin: download source: - image_url - '@filename' destination: plugin: 'public://images' rename: true destination: plugin: 'entity:node' default_bundle: article migration_dependencies: required: - categories_from_csv בתצורת המקור. כך רק רשומות חדשות או שונות יוגרו. זה שימושי במיוחד להגירה מצטברת לאחר הייבוא הראשוני. דוגמת תצורה:

highwaterProperty: name: updated_at alias: u 

הגירת קבצי מדיה וייבוא מצטבר

הגירת קבצי מדיה כוללת תמונות וקבצים המוגרים בקובץ YAML נפרד, ולאחר מכן מקושרים לישויות דרך <?php // src/Plugin/migrate/source/ExternalApiSource.php namespace Drupal\mymodule\Plugin\migrate\source; use Drupal\migrate\Plugin\migrate\source\SourcePluginBase; /** * @MigrateSource( * id = "external_api", * source_module = "mymodule" * ) */ class ExternalApiSource extends SourcePluginBase { public function getIds(): array { return ['id' => ['type' => 'integer']]; } public function fields(): array { return [ 'id' => 'ID записи', 'title' => 'Заголовок', 'content' => 'Содержимое', 'tags' => 'Теги (через запятую)', ]; } protected function initializeIterator(): \Iterator { $page = 0; do { $response = \Drupal::httpClient()->get( 'https://api.external.com/posts?page=' . $page, ['headers' => ['Authorization' => 'Bearer ' . $this->configuration['api_key']]] ); $data = json_decode($response->getBody(), true); $items = $data['items']; foreach ($items as $item) { yield $item; } $page++; } while (!empty($items) && $page < $data['total_pages']); } } . דוגמת הגירת קבצים:

---
id: files_migration
source:
  plugin: csv
  path: 'public://import/files.csv'
process:
  filename:
    plugin: callback
    callable: basename
    source: file_url
  uri:
    plugin: download
    source:
      - file_url
      - '@filename'
    destination:
      plugin: 'public://migrated'
  destination:
    plugin: 'entity:file'

בהגירת הצומת, השדה track_changes: true משתמש ב-highwaterProperty: name: updated_at alias: u כדי להפנות לקובץ שהועלה.

מה כלול בשירותי הגירת התוכן שלנו?

תוצרים: כחלק מפתרון מפתח, אנו מספקים:

• תיעוד מבנה ההגירה
• גישה למאגר עם התצורה
• אופטימיזציית ביצועים: גודל אצווה, סימן מים גבוה, עיבוד מקבילי
• הכשרה למפתחים שלכם על שימוש ב-Migrate
• חודש תמיכה לאחר ההשקה
• אחריות להפעלה רציפה של האתר במהלך ההגירה
• עלות: $500 - $3000 בהתאם למורכבות

לוח זמנים

הגירה פשוטה מ-CSV (500–5000 רשומות) — 2–3 ימים. הגירה מורכבת ממספר מקורות עם תוספים וטרנספורמציות מותאמים אישית — 1–2 שבועות. לוח הזמנים המדויק נקבע במהלך בדיקה.

מדוע הגירה עם Migrate עדיפה על העברה ידנית?

הגירה באמצעות Migrate אינה רק עניין של מהירות אלא גם של הבטחת שלמות. אנו משתמשים בשיטות מומלצות: סימן מים גבוה, migration_lookup, id: files_migration source: plugin: csv path: 'public://import/files.csv' process: filename: plugin: callback callable: basename source: file_url uri: plugin: download source: - file_url - '@filename' destination: plugin: 'public://migrated' destination: plugin: 'entity:file' . המהנדסים שלנו מחזיקים בהסמכות Drupal ויש להם ניסיון עם פרויקטים העולים על 500,000 רשומות תוכן. צרו קשר כדי לדון במשימה שלכם. קבלו ייעוץ הגירה.