Первый взгляд на Atlas — ORM, который обеспечивает

 //Start updating $newCategory = $atlas->fetchRecord(CategoryMapper::CLASS, '2'); $newCategory->name = "Wood"; // create a transaction $transaction = $atlas->newTransaction(); // plan work for the transaction $transaction->update($newCategory); //$transaction->delete($newCategory); // execute the transaction plan $ok = $transaction->exec(); if ($ok) { echo "Transaction success."; } else { echo "Transaction failure. "; } //End updating 

В этом случае мы можем использовать либо update вместе с новыми значениями таблицы, чтобы обновить запись, либо delete чтобы удалить эту же запись.

Краткое примечание об отношениях

Atlas поддерживает все четыре вида отношений: OneToMany , ManyToOne , OneToOne и MantToMany . Чтобы добавить отношения, мы должны добавить их в классы Mapper.

В нашем конкретном случае давайте представим, что в каждой категории может быть много товаров. Отношения один ко многим. Наш CategoryMapper будет выглядеть так:

 <?php namespace App\DataSource\Category; use Atlas\Orm\Mapper\AbstractMapper; use App\DataSource\Products\ProductsMapper; /** * @inheritdoc */ class CategoryMapper extends AbstractMapper { /** * @inheritdoc */ protected function setRelated() { $this->oneToMany('products', ProductsMapper::CLASS); } } 

По умолчанию связь берет первичный ключ в исходной таблице и сопоставляет его с соответствующим столбцом в целевой таблице. Конечно, в случае, когда у нас отношения много к одному, это невозможно. В этом случае будет сделано обратное. Первичный ключ в таблице назначения будет сопоставлен с соответствующим столбцом в таблице происхождения.

Итак, если мы хотим получить RecordSet наших категорий с соответствующими записями о продуктах, мы можем использовать метод with() , вот так:

 $newRecord = $atlas ->select(CategoryMapper::CLASS) ->with([ 'products' ]) ->fetchRecordSet(); 

Зная, как работают основные операции CRUD, мы можем теперь взглянуть на некоторые более практичные примеры кода с использованием Atlas.

Некоторые практические примеры

Здорово иметь такой инструмент, как Atlas, и посмотреть, как он работает. Но в конечном итоге мы хотим, чтобы он использовался в более практичных сценариях. Хотя мы не будем создавать полноценное приложение, мы рассмотрим некоторые возможные варианты использования.

Есть некоторые операции, которые мы используем каждый день, даже не замечая, такие как получение информации, вставка и удаление записей базы данных. Как бы они выглядели, используя Atlas?

 <?php require_once __DIR__ . '/vendor/autoload.php'; use Atlas\Orm\Mapper\Mapper; use Atlas\Orm\AtlasContainer; use App\DataSource\Category\CategoryMapper; use App\DataSource\Products\ProductsMapper; /** * This function will create and return our Atlas instance set up * with both our Mappers * * @return $atlasContainer */ function getAtlasContainer(){ $atlasContainer = new AtlasContainer('mysql:host=localhost;dbname=atlasorm','root', '' ); $atlasContainer->setMappers([ProductsMapper::CLASS, CategoryMapper::CLASS]); return $atlasContainer->getAtlas(); } /** * This function will return a RecordSet of all our products * * @return RecordSet */ function getAllProducts(){ $atlas = getAtlasContainer(); $productsRecordSet = $atlas ->select(ProductsMapper::CLASS) ->fetchRecordSet(); return $productsRecordSet; } /** * This function will return a Record of the Product with the specified id * * @param int * @return Record */ function getProductById( $id ){ $atlas = getAtlasContainer(); $productRecord = $atlas->fetchRecord(ProductsMapper::CLASS, $id); return $productRecord; } /** * This function will insert a new product Record * * @param string $product_name * @param int $category_name */ function addProduct( $product_name, $category_id ){ $atlas = getAtlasContainer(); //First we check if the category exists $categoryRecord = $atlas->fetchRecord(CategoryMapper::CLASS, $category_id); //if our category exists we will insert our product if( $categoryRecord ){ //Start insert $newProduct = $atlas->newRecord(ProductsMapper::CLASS); $newProduct->name = $product_name; $newProduct->category_id = $category_id; // create a transaction $transaction = $atlas->newTransaction(); $transaction->insert($newProduct); // execute the transaction $ok = $transaction->exec(); if ($ok) { echo "Transaction success."; } else { // get the exception that was thrown in the transaction $exception = $transaction->getException(); $work = $transaction->getFailure(); echo "Transaction failure. "; echo $work->getLabel() . ' threw ' . $exception->getMessage(); } //End insert }else{ echo 'The category is not valid.'; } } /** * This function will delete a product Record * * @param id $product_id */ function deleteProduct( $product_id ){ $atlas = getAtlasContainer(); //First, lets check if the product with $product_id exists $productRecord = $atlas->fetchRecord(ProductsMapper::CLASS, $product_id); if( $productRecord ){ //Delete the product $transaction = $atlas->newTransaction(); $transaction->delete($productRecord); // execute the transaction $ok = $transaction->exec(); if ($ok) { echo "Transaction success."; } else { // get the exception that was thrown in the transaction $exception = $transaction->getException(); $work = $transaction->getFailure(); echo "Transaction failure. "; echo $work->getLabel() . ' threw ' . $exception->getMessage(); } }else{ echo 'The product you are trying to delete does not exist.'; } } 

Очень простой каркас операций с использованием Atlas (без ООП и современных концепций программирования, потому что это всего лишь демонстрация).

Предостережения

Наконец, давайте посмотрим на два предостережения.

• Атлас использует генерацию кода . Если вы измените таблицу базы данных, в которой уже был сгенерирован код, и повторно создадите ее, класс mapper не будет переопределен. Это особенно полезно, если вы написали собственный код в классе mapper.

• Atlas находится в стадии разработки , 1.0.0-alpha1 был выпущен совсем недавно. Будьте очень осторожны при его использовании, особенно если вы пытаетесь использовать его в производственной среде, поскольку критические изменения могут повлиять на ваши проекты.

Вывод

Концепция Atlas оригинальна, и ее легко понять и использовать. Отсутствие аннотаций и очень мало аспектов генерации кода — это действительно сильные стороны, особенно если вы, как и я, хотите, чтобы ваш код был максимально изолированным и независимым.

Что вы думаете об Атласе? Вы дадите ему вращение?