마젠토의 수동 인덱싱 제어

마젠토의 인덱싱 기능은 마젠토의 전체적인 성능을 향상시키는데 큰 역할을 합니다.
인덱싱을 사용함으로써 얻을수 있는 장점은 제품의 데이터와 검색 인덱스는 물론, 속성(attribute), 가격(price), URL 규칙(url rewrite), 재고관리(stock) 까지 많은 부분을 미리 간단한 형식의 데이터로 변환시켜 놓음으로써 페이지의 로딩속도와 전체적인 퍼포먼스를 향상시켜 줍니다.
이러한 인덱스 기능은 관리자 모드에서 손쉽게 조절할수 있지만, 개발자로써 모듈개발이나 마젠토의 기능을 수정할때 이러한 인덱스 기능을 제한적으로 꺼야한다거나 다시 켜야할때 그리고 모든 항목을 자동으로 인덱스해야 할때가 종종 있습니다.
특히 제품을 한번에 왕창 업로드 한다던지, 3rd party와 연계되어 제품정보를 실시간으로 업데이트 시킬때 등등 유용하게 사용되는데요, 그럴때마다 수동으로 마젠토의 관리자 모드로 들어가 직접 인덱스 기능을 컨트롤 할수는 없습니다.
그렇기 때문에 아래의 코드는 간단하지만 모듈이나 크론잡(Cronjob)에서 상당히 유용하게 쓰입니다.

마젠토 인덱스 프로세스의 종류는 9가지 종류가 있는데 관리자 모드에서 System > Index Management에서 인덱싱 제어가 가능하구요, 인덱싱의 종류는 아래 테이블을 참고하세요.

아이디	코드	프로세스 이름
1	catalog_product_attribute	Product Attributes
2	catalog_product_price	Product Prices
3	catalog_url	Catalog URL Rewrites
4	catalog_product_flat	Product Flat Data
5	catalog_category_flat	Category Flat Data
6	catalog_category_product	Category Products
7	catalogsearch_stock	Catalog Search Index
8	cataloginventory_stock	Stock Status
9	tag_summary	Tag Aggregation Data

위에 나열된 인덱스 프로세스 각각의 아이디와 코드를 사용해서 아래와같이 제어가 가능합니다.

아이디를 사용해 인덱스 프로세스 불러오기
[ccln_php]
// 프로세스 로딩
$process_id = 1; // catalog_product_attribute
$process = Mage::getModel('index/process');
$process->load($process_id);
// reindex
$process->reindexAll();
?>
[/ccln_php]

프로세스 코드를 사용해 인덱스 프로세스 불러오기
[ccln_php]
// 프로세스 로딩: process id - 1
$process = Mage::getModel('index/indexer');
$process->getProcessByCode('catalog_product_attribute');
// reindex
$process->reindexAll();
?>
[/ccln_php]

프로세스를 "Update on Save"나 "Manual Update"로 바꾸기:
("Update on Save/Manual Update"은 마젠토 관리자 모드의 Index Management에서 Index Mode를 바꾸는데 나오는 옵션입니다)
[ccln_php]
// 프로세스 로딩
$process_id = 2; // catalog_product_price
$process = Mage::getModel('index/process');
$process->load($process_id);

// Manual Update
$process->setMode(Mage_Index_Model_Process::MODE_MANUAL);
$process->save();

// Update on Save
$process->setMode(Mage_Index_Model_Process::MODE_REAL_TIME);
$process->save();
?>
[/ccln_php]

마젠토 region 과 country 코드

마젠토에는 국가별 코드와 이름이 이미 데이터베이스에 기본적으로 저장되어있고, 미국같은 경우는 state 코드/이름 또한 저장되어있습니다.
간혹 개발자가 커스텀으로 모듈이나 템플릿을 만드는 도중 마젠토 데이터베이스에 저장되어있는 국가(country)나 state(region)을 불러내야 할 경우가 있는 있는데, 아마도 아래 코드가 도움이 되리라 생각됩니다.

[ccln_php]
// 국가의 콜렉션 로딩
$countryCollection = Mage::getModel('directory/country_api')->items();

// 위의 콜렉션을 select dropdown box에 넣어야 할 경우
?>

foreach($countryCollection as $country) :
?>

endforeach;
?>

[/ccln_php]

국가의 콜렉션을 사용하려면 directory/country_api 모델을 사용해야 합니다.
마찬가지로 region 콜렉션을 사용하려면 아래와 같이 directory/region_api 모델을 사용해야 합니다.

[ccln_php]
// region 콜렉션 로딩
// $counotryCode 는 국가 코드
$regionCollection = Mage::getModel('directory/region_api')->items($countryCode);

// 위의 콜렉션을 select dropdown box에 넣어야 할 경우
?>

Please select region, state or province
foreach($regionCollection as $region) :
?>

endforeach;
?>

[/ccln_php]


국가 코드로 국가 이름 불러오기
[ccln_php]
$countryName = Mage::getModel('directory/country')->load($countryCode)->getName();
?>
[/ccln_php]

마젠토에 category attribute 생성 및 삭제

마젠토는 EAV(Entity Attribute Value) 모델을 사용함으로써 각각의 객체모델에 attribute과 attribute의 값어치(value)를 생성시킬수 있습니다.
예를들어 product model 같은경우 마젠토 admin에서 새로운 product attribute을 생성시킬수 있습니다. 그리고 그 attribute의 갯수는 얼마든지 무한대로 늘일수 있습니다.

하지만 category model의 경우 마젠토 admin에서 새로운 category attribute을 생성시키는 기능이 없기 때문에 새로운 attribute을 카테고리에 더하고 싶어도 할수가 없습니다.
사실 마젠토 admin에서 category attribute을 생성시키는 기능이 없는 것일뿐 못하는것은 아닙니다.
마젠토는 EAV 모델을 사용하고 있고 product model과 마찬가지로 category model 또한 entity이며 그 entity에는 attribute과 value를 생성시킬수 있기 때문에 category attribute도 생성시킬수 있습니다.

그렇다고 이것을 phpMyAdmin 이나 adminer 같은 데이터베이스 툴을 사용해서 데이터베이스에 직접 attribute을 생성시키는것은 많은 위험이 따르구요,
아래와 같은 코드로 손쉽게 생성 및 삭제시킬수 있습니다.

category attribute 생성
[ccln_php]
// 마젠토 로딩
Mage::app();

// EAV 모델 셋업 model
$setup = new Mage_Eav_Model_Entity_Setup('core_setup');

// 이미지 셀렉터 생성
$setup->addAttribute('catalog_category', 'extra_image', array(
'group' => 'General',
'input' => 'image',
'type' => 'varchar',
'label' => 'Slider Image',
'backend' => 'catalog/category_attribute_backend_image',
'visible' => 1,
'required' => 0,
'user_defined' => 1,
'global' => Mage_Catalog_Model_Resource_Eav_Attribute::SCOPE_GLOBAL,
));

// 텍스트 필드 생성
$setup->addAttribute('catalog_category', 'extra_text', array(
'group' => 'General',
'input' => 'textarea',
'type' => 'text',
'label' => 'SEO Text',
'backend' => '',
'visible' => 1,
'required' => 0,
'user_defined' => 1,
'global' => Mage_Catalog_Model_Resource_Eav_Attribute::SCOPE_GLOBAL,
));

// Yes, No같은 boolean value 생성
$setup->addAttribute('catalog_category', 'extra_boolean', array(
'group' => 'General',
'input' => 'select',
'type' => 'int',
'label' => 'Yes or No',
'backend' => '',
'source' => 'eav/entity_attribute_source_boolean',
'visible' => 1,
'required' => 0,
'user_defined' => 1,
'global' => Mage_Catalog_Model_Resource_Eav_Attribute::SCOPE_GLOBAL,
));
?>
[/ccln_php]

위의 코드는 extra_image, extra_text 그리고 extra_boolean 이란 category attribute을 생성시키는 코드구요, 마젠토 admin에서 category로 들어가시면 각각의 카테고리에 3개의 새로생긴 필드를 찾을수 있습니다.
각각의 attribute에서
group은 attribute이 나오는 그룹
input은 input 필드의 타입
type은 데이터베이스에 저장되는 value의 type
label은 admin에 나오는 텍스트 레이블
backend는 input 필드가 사용할 model
source는 기본적으로 데이터베이스에 저장되어 있는 값어치
를 나타냅니다.

반대로 생성된 attribute을 삭제하는 방법은 아래 코드를 참조하세요.
[ccln_php]
// 마젠토 로딩
Mage::app();

// EAV 모델 셋업 model
$setup = new Mage_Eav_Model_Entity_Setup('core_setup');

// category attribute 삭제
$setup->removeAttribute('catalog_category', 'extra_image');
$setup->removeAttribute('catalog_category', 'extra_text');
$setup->removeAttribute('catalog_category', 'extra_boolean');
?>
[/ccln_php]

위의 코드는 새로 생성된 3개의 category attribute을 삭제시킵니다.

마젠토 콜렉션(Collection) 사용하기

마젠토 콜렉션(Collection)은 한번에 여러개의 객체(product, customer, category 등등)를 불러오는데 사용됩니다.
예를들어 카테고리 페이지에있는 모든 제품을 불러온다던지, 모든 커스토머(customer) 정보를 불러올때 유용하게 쓰입니다.

아래와 같은 php코드를 루트에 올려놓고 시험해 보세요.
[ccln_php]
require_once "app/Mage.php";
Mage::app();

// 모든 제품 불러오기
$collection = Mage::getResourceModel('catalog/product_collection'); // 첫번째 방법
$collection = Mage::getModel('catalog/product')->getCollection(); // 두번째 방법

// 모든 제품이 필요하지는 않으므로 5개만 로드합니다.
$collection->getSelect()->limit(5);
$collection->load(); // 콜렉션을 불러옵니다.
foreach($collection AS $product) {
// 제품의 모든 데이터 출력
print_r($product->getData());
}
[/ccln_php]
위의 코드를 실행해 보시면 제품의 모든 데이터가 출력이 됩니다.
콜렉션 객체를 불러올때 두가지 방법을 보여드렸는데 첫번째 방법과 두번째 방법의 결과가 약간은 틀린걸 확인할수 있습니다.

첫번째 방법은 최소한의 데이터만 로드함으로써 메모리의 사용을 최대한 줄이는 방법이고,
$collection = Mage::getResourceModel('catalog/product_collection');

두번째 방법은 제품의 모든 데이터를 불러옴으로써 메모리 사용에 상관없이 콜렉션을 사용하는 방법입니다.
$collection = Mage::getModel('catalog/product')->getCollection();

개인적으로 메모리 사용이 적은 첫번째 방법을 선호합니다.
그렇다고 필요한 제품의 데이터를 불러오지 못하는것은 아닙니다.
아래와 같이 addAttributeToSelect()을 사용해서 필요한 Attribute을 불러올수 있습니다.
[ccln_php]
require_once "app/Mage.php";
Mage::app();

$collection = Mage::getResourceModel('catalog/product_collection');

// 아래처럼 원하는 attribute을 콜렉션에 포함시킬수 있습니다.
$collection->addAttributeToSelect('price');
$collection->addAttributeToSelect('weight');

// 모든 제품이 필요하지는 않으므로 5개만 로드합니다.
$collection->getSelect()->limit(5);
$collection->load(); // 콜렉션을 불러옵니다.
foreach($collection AS $product) {
// 제품의 모든 데이터 출력
print_r($product->getData());
}
[/ccln_php]


Attribute으로 불러올 데이터를 addAttributeToFilter()를 사용해서 걸러낼수도 있습니다.
예를들어 id가 10보다 커야 한다던지 sku가 'abcd'를 포함해야 하는경우 아래와 같이 콜렉션을 설정할수 있습니다.
[ccln_php]
require_once "app/Mage.php";
Mage::app();

$collection = Mage::getResourceModel('catalog/product_collection');

// 아래처럼 원하는 attribute을 콜렉션에 포함시킬수 있습니다.
// product entity_id가 10보다 커야하는경우
$collection->addAttributeToFilter('entity_id', array('gt' => 10));

// price가 $100 이하여야 하는 경우
$collection->addAttributeToFilter('price', array('lt' => 100));

// sku가 'abcd'를 포함해야 하는 경우
$collection->addAttributeToFilter('sku', array('like' => '%abcd%'));

// sku가 'zzz1'이 아니어야 하는 경우
$collection->addAttributeToFilter('sku', array('neq' => 'zzz1'));

// description이 아무것도 없는 제품을 포함하는 경우
$collection->addAttributeToFilter('description', 'null');

$collection->load(); // 콜렉션을 불러옵니다.
foreach($collection AS $product) {
// 제품의 모든 데이터 출력
print_r($product->getData());
}
[/ccln_php]

이런식으로 addAttributeToSelect()나 addAttributeToFilter()를 사용해서 원하는 attribute을 콜렉션에 포함시키거나 필터를 적용해서 걸러낼수 있습니다.
콜렉션의 사용은 한번에 많은 객체를 불러와야 할때, 또 한번에 여러 객체의 정보를 수정해야할때 유용하게 쓰입니다.

마젠토의 싱글턴 패턴

마젠토의 싱글턴 패턴
getSingleton()과 getModel()의 차이점과 사용법

싱글턴 패턴은 하나의 클래스에서 하나의 인스턴스만을 생성하도록 하는 소프트웨어 디자인 패턴중의 하나입니다.
마젠토에서 이런 싱글턴 패턴의 사용은 객체의 인스턴스 생성 남용을 막으려는 방법이고 결과적으로 메모리의 사용을 최소화하기 위한 방책입니다.

예를 들자면 데이터베이스 인스턴스가 가장 대표적인 예입니다.
페이지가 로딩되면서 여러번의 데이터베이스 사용이 필요할수 있지만 데이터베이스 연결 인스턴스는 하나면 족합니다.
데이터베이스를 사용할때마다 똑같은 데이터베이스에 연결시키는 인스턴스를 여러번 생성하게되면 불필요한 리소스를 낭비하게 됩니다.
이럴때 이미 생성된 데이터베이스 인스턴스를 재활용하고자 하는것이 기본적인 싱글턴 패턴의 컨셉트 입니다.

마젠토에서 객체 인스턴스를 생성하는 방법은 getSingleton('모델/클래스'); 또는 getModel('모델/클래스'); 이 사용되는데 getSingleton('모델/클래스')의 경우 인스턴스가 이미 생성되어있지 않은경우 getModel('모델/클래스') method를 호출하게 됩니다.
아래는 app/Mage.php의 getSingleton() 와 getMethod() method입니다.
[ccln_php]
// getSingleton
public static function getSingleton($modelClass='', array $arguments=array())
{
$registryKey = '_singleton/'.$modelClass;
if (!self::registry($registryKey)) {
self::register($registryKey, self::getModel($modelClass, $arguments));
}
return self::registry($registryKey);
}

// getModel
public static function getModel($modelClass = '', $arguments = array())
{
return self::getConfig()->getModelInstance($modelClass, $arguments);
}
[/ccln_php]

getModel()의 사용예
[ccln_php]
// $productId를 이용한 product 객체의 인스턴스 생성,
$product = Mage::getModel('catalog/product')->load($productId);
// product의 이름 가져오기
$name = $product->getName();
[/ccln_php]

getSingleton()의 사용예
[ccln_php]
// customer session 불러오기
$customerSession = Mage::getSingleton('customer/session');
// customer 인스턴스 불러오기
$customer = $customerSession->getCustomer();
[/ccln_php]

getModel()과 getSingleton()의 비교

[ccln_php]
// getSingleton()을 사용하여 product 객체를 product_id 34로 로딩
$product = Mage::getSingleton('catalog/product')->load(34);
echo $product->getId(); // 34 가 출력됨

// getModel()을 사용하여 product 객체를 로딩
$product = Mage::getModel('catalog/product');
echo $product->getId(); // 아무것도 출력되지 않음
// getModel()은 새로운 객체를 생성하기 때문에 아무것도 출력되지 않음

// getSingleton()을 사용하여 이미 존재하는 product 객체를 로딩
$product = Mage::getSingleton('catalog/product');
echo $product->getId(); // 34 가 출력됨
[/ccln_php]

line 11의 경우, getSingleton()은 이미 생성된 객체를 불러오기 때문에 굳이 product_id 를 로딩하지 않아도 위의 line 2에서 생성된 객체를 자동으로 로딩하게 됩니다.
그래서 line 12에서는 기존에 로딩되어있던 product 객체의 id를 출력하게 됩니다.

마젠토 객체의 데이터 불러오기

마젠토 getModel()과 getData()를 사용한 객체의 데이터 불러오는 방법

마젠토 객체의 데이터를 불러오는 방법입니다. getModel()과 getData()를 사용하며 마젠토의 객체를 불러오는 방식은 대부분 동일합니다.

마젠토에서는 객체를 불러올때 대체로 getModel() method를 사용하고 불러온 객체의 데이터를 가져올때 getData() method를 사용합니다.
method의 이름이 무엇을 할때 쓰이는지 이미 알려주듯이 사용법 또한 그리 어렵지 않습니다.
이번 포스팅에서는 객체를 불러와 객체를 아이디로 로드하는 방법, 그리고 객체내에 있는 데이터를 불러오는 방법을 보여드립니다.

예를들어 product 객체를 불러올때엔 아래와 같은 코드를 실행하시면 됩니다.
[ccln_php]
$product = Mage::getModel('catalog/product');
?>
[/ccln_php]
한마디로 Mage_Catalog_Model_Product의 객체를 불러오는 것이며 getModel() 안에있는 'catalog/product'는 Mage_Catalog_Model_Product 를 나타냅니다.
Mage_Catalog_Model_Product는 /app/code/core/Mage/Catalog/Model/Product.php 에 위치하고 있으며 Mage_Catalog_Model_Abstract 에서 계승되어 내려온 클래스입니다.
다른 객체를 불러올때도 같은 방법을 사용하며 파일의 위치또한 같은 형식의 폴더안에 위치해 있습니다.

category 객체나 customer 객체를 불러올때도 같은 형식입니다.
[ccln_php]
$category = Mage::getModel('catalog/category');
$customer = Mage::getModel('customer/customer');
?>
[/ccln_php]
category의 경우 Mage_Catalog_Model_Category의 객체를 불러오는 것이며 해당 파일은 /app/code/core/Mage/Catalog/Model/Category.php 에 위치해 있습니다.
customer의 경우 Mage_Customer_Model_Customer의 객체를 불러오는 것이며 해당 파일은 /app/code/core/Mage/Customer/Model/Customer.php 에 위치해 있습니다.

위와같이 product, category, customer 객체를 불러왔을때엔 그 객체 안에는 아직 아무것도 없고 객체를 사용해서 할수있는 일도 몇가지 안됩니다.
객체를 불러온 후에는 product_id, category_id 또는 customer_id를 사용해서 각각의 정보를 로딩해야 합니다.

아래는 product_id '3'을 가진 product를 $product에 로딩시킨후 로딩된 객체의 정보를 getData() method를 사용해서 프린트하는 코드입니다.
마젠토의 root 폴더에 임의의 파일을 만들어 아래 코드를 복사해서 실행시킬수 있습니다.
[ccln_php]
require_once "app/Mage.php";

$product = Mage::getModel('catalog/product')->load(3);
echo '

'; // 어레이를 조금 보기 쉽게 하기 위해서...
print_r($product->getData());

// product의 이름 출력하는 방법
echo $product->getName();
echo $product->getData('name');
// product의 sku 출력하는 방법
echo $product->getSku();
echo $product->getData('sku');
// product의 가격 출력하는 방법
echo $product->getPrice();
echo $product->getData('price');
?>
[/ccln_php]

print_r($product->getData()); 를 프린트 해 보시면 array 안에 product에 관련된 모든 attribute들이 데이터 형식으로 들어있는것을 볼수 있습니다.
그 데이터를 불러올때엔 
$product->get{attribute 이름}(); 형식을 사용하면 되고, 
$product->getData('{attribute 이름}');의 형식도 사용 가능합니다.
다만 $product->get{attribute 이름}(); 의 경우 {attribute 이름}의 첫번째 알파벳은 대문자가 되어야 합니다.

마젠토 세션 사용법

기본적인 마젠토 세션 변수 사용방법:
변수를 만들어 세션에 저장하거나 저장해놓은 값을 사용하고자 할때엔 아래와 같이 변수 이름앞에 set또는 get을 사용하시면 됩니다.
[ccln_php]
// 지정하기
Mage::getSingleton('core/session')->setMyData('my data');
// 가져오기
$myData = Mage::getSingleton('core/session')->getMyData();
echo $myData; // prints 'my data'
// 지우기
Mage::getSingleton('core/session')->setMyData();
?>
[/ccln_php]

마젠토 외부에서 관리자 세션(Admin Session) 불러오기
[ccln_php]
require_once "app/Mage.php";
Mage::app();
Mage::getSingleton('core/session', array('name'=>'adminhtml'));
$session = Mage::getSingleton('admin/session');
// 로그인 여부 확인
if($session->isLoggedIn()) {
$customer = $session->getCustomer();
}
[/ccln_php]

마젠토 외부에서 프론트엔드 세션(Frontend Session) 불러오기
[ccln_php]
require_once "app/Mage.php";
Mage::app();
Mage::getSingleton('core/session', array('name' => 'frontend'));
$session = Mage::getSingleton('customer/session');
$customer_id = 'guest';
// 로그인 여부 확인
if($session->isLoggedIn()) {
$customer = $session->getCustomer();
}
[/ccln_php]