Asas Pemetaan Hubungan Objek (ORM): Memahami Doktrin ORM

Asas Pemetaan Perhubungan Objek (ORM): Memahami Doktrin ORM

Apabila kami membangunkan aplikasi, kami perlu mengendalikan pangkalan data untuk menyimpan dan mendapatkan semula data. Walau bagaimanapun, adalah menyusahkan untuk menggunakan kod pertanyaan pangkalan data asal secara langsung. Kita perlu mewujudkan hubungan pemetaan antara objek dan data Ini adalah peranan ORM. ORM secara automatik memetakan dan menukar objek dan jadual pangkalan data, membolehkan manipulasi data mudah, menjadikan kod kami lebih mudah untuk diselenggara.

Doktrin ORM ialah salah satu rangka kerja ORM yang paling popular dalam PHP. Ia menggunakan kaedah yang mudah tetapi berkesan untuk memetakan objek PHP dan jadual pangkalan data, menyediakan API yang mudah digunakan untuk operasi CRUD.

Artikel ini akan memperkenalkan beberapa pengetahuan asas tentang ORM Doktrin, termasuk konfigurasi, entiti, pemetaan, pertanyaan, dsb.

Konfigurasi

Sebelum kita mula, kita perlu memasang Doktrin ORM. Ia boleh dipasang melalui Komposer, menggunakan arahan berikut:

composer require doctrine/orm

Seterusnya, dalam fail PHP kami, kami perlu memulakan Doktrin. Ini boleh dilakukan melalui kod berikut:

use DoctrineORMToolsSetup;
use DoctrineORMEntityManager;

require_once "vendor/autoload.php";

$paths = array("path/to/entity-files");
$isDevMode = false;

// the connection configuration
$dbParams = array(
    'driver'   => 'pdo_mysql',
    'user'     => 'your_database_user',
    'password' => 'your_database_password',
    'dbname'   => 'your_database_name',
);

$config = Setup::createAnnotationMetadataConfiguration($paths, $isDevMode);
$entityManager = EntityManager::create($dbParams, $config);

Dalam kod di atas, kami mula-mula menentukan laluan ke fail entiti. Kami kemudiannya menentukan parameter sambungan pangkalan data seperti pemacu, nama pengguna, kata laluan dan nama pangkalan data. Akhir sekali, kami menggunakan fungsi Setup::createAnnotationMetadataConfiguration() untuk mengkonfigurasi metadata, dan kemudian menggunakan fungsi EntityManager::create() untuk mencipta pengurus entiti.

Entiti

Malah, Model dan Entiti adalah perkara yang sama. Kita perlu mencipta kelas entiti untuk memetakan jadual pangkalan data. Kelas ini perlu mewarisi kelas DoctrineORMMappingClassMetadata dan menggunakan anotasi DoctrineORMMappingEntity dan DoctrineORMMappingTable.

use DoctrineORMMapping as ORM;

/**
 * @ORMEntity
 * @ORMTable(name="users")
 */
class User
{
    /**
     * @ORMId
     * @ORMGeneratedValue
     * @ORMColumn(type="integer")
     */
    private $id;

    /**
     * @ORMColumn(type="string")
     */
    private $name;

    /**
     * @ORMColumn(type="string", length=100, unique=true)
     */
    private $email;

    // ... getters and setters
}

Dalam kod di atas, kami telah menentukan kelas entiti Pengguna yang akan memetakan jadual pangkalan data bernama "pengguna". Ia mempunyai tiga atribut: $id, $name dan $email. Anotasi memberitahu Doktrin ORM cara memetakan sifat ini, contohnya sifat $id ialah kunci utama dan dinaikkan secara automatik, sifat $name dipetakan ke lajur pangkalan data jenis varchar, sifat $e-mel dipetakan untuk menaip varchar dan mestilah unik dalam jadual pangkalan data.

Pemetaan

Selepas kita mentakrifkan entiti, kita perlu memberitahu Doktrin ORM cara memetakan entiti ke jadual pangkalan data. Kita boleh menggunakan XML, ulasan atau YAML untuk menentukan hubungan pemetaan.

Di sini, kami menggunakan anotasi untuk menentukan hubungan pemetaan. Sebagai contoh, dalam kod di bawah, kami mentakrifkan hubungan pemetaan untuk memetakan entiti Pengguna ke users jadual pangkalan data:

/**
 * @ORMEntity
 * @ORMTable(name="users")
 */
class User
{
    // properties ...

    // many-to-one association
    /**
     * @ORMManyToOne(targetEntity="Department")
     * @ORMJoinColumn(name="department_id", referencedColumnName="id")
     */
    private $department;
}

Dalam kod di atas, kami mentakrifkan hubungan pemetaan antara entiti Pengguna dan Jabatan entiti Perhubungan banyak-dengan-satu. Semua definisi perhubungan pemetaan perlu ditandakan dengan anotasi.

Pertanyaan

Doktrin ORM menyediakan API pertanyaan yang mudah digunakan yang membolehkan kami melaksanakan operasi CRUD dengan mudah. Sebagai contoh, kod berikut menunjukkan cara untuk menanyakan entiti menggunakan Doktrin:

$userRepository = $entityManager->getRepository('User');
$users = $userRepository->findAll();

foreach ($users as $user) {
    echo sprintf("-%s
", $user->getName());
}

Dalam kod di atas, kami menggunakan pembolehubah $entityManager untuk mendapatkan contoh repositori Pengguna. Kami kemudian mendapatkan semula semua kejadian Pengguna menggunakan kaedah findAll(), mencetak nama pengguna setiap tika.

Ringkasan

Artikel ini memperkenalkan pengetahuan asas ORM Doktrin, termasuk konfigurasi, entiti, pemetaan dan pertanyaan. ORM ialah alat yang sangat berkuasa yang boleh memudahkan pengekodan fungsi berkaitan pangkalan data. Saya harap artikel ini akan membantu anda memahami ORM, dan saya harap anda boleh mengetahui lebih lanjut tentang Doktrin ORM dan mula menggunakannya.

Atas ialah kandungan terperinci Asas Pemetaan Hubungan Objek (ORM): Memahami Doktrin ORM. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!