3 namespace Civi\Payment
;
7 * @package Civi\Payment
14 private static $singleton;
19 private $cache = array();
22 * @return \Civi\Payment\System
24 public static function singleton() {
25 if (!self
::$singleton) {
26 self
::$singleton = new self();
28 return self
::$singleton;
32 * Starting from the processor as an array retrieve the processor as an object.
34 * If there is no valid configuration it will not be retrieved.
36 * @param array $processor
38 * Override the config check. This is required in uninstall as no valid instances exist
39 * but will deliberately not work with any valid processors.
41 * @return \CRM_Core_Payment|NULL
43 * @throws \CRM_Core_Exception
45 public function getByProcessor($processor, $force = FALSE) {
46 $id = $force ?
0 : $processor['id'];
48 if (!isset($this->cache
[$id]) ||
$force) {
49 $ext = \CRM_Extension_System
::singleton()->getMapper();
50 if ($ext->isExtensionKey($processor['class_name'])) {
51 $paymentClass = $ext->keyToClass($processor['class_name'], 'payment');
52 require_once $ext->classToPath($paymentClass);
55 $paymentClass = 'CRM_Core_' . $processor['class_name'];
56 if (empty($processor['class_name'])) {
57 throw new \
CRM_Core_Exception('no class provided');
61 $processorObject = NULL;
62 if (class_exists($paymentClass)) {
63 $processorObject = new $paymentClass(!empty($processor['is_test']) ?
'test' : 'live', $processor);
64 if ($force ||
!$processorObject->checkConfig()) {
65 $processorObject->setPaymentProcessor($processor);
68 $this->cache
[$id] = $processorObject;
71 return $this->cache
[$id];
75 * Execute checkConfig() on the payment processor Object.
76 * This function creates a new instance of the processor object and returns the output of checkConfig
78 * @param array $processor
82 * @throws \CRM_Core_Exception
84 public function checkProcessorConfig($processor) {
85 $ext = \CRM_Extension_System
::singleton()->getMapper();
86 if ($ext->isExtensionKey($processor['class_name'])) {
87 $paymentClass = $ext->keyToClass($processor['class_name'], 'payment');
88 require_once $ext->classToPath($paymentClass);
91 $paymentClass = 'CRM_Core_' . $processor['class_name'];
92 if (empty($paymentClass)) {
93 throw new \
CRM_Core_Exception('no class provided');
95 require_once str_replace('_', DIRECTORY_SEPARATOR
, $paymentClass) . '.php';
98 $processorObject = new $paymentClass(!empty($processor['is_test']) ?
'test' : 'live', $processor);
99 return $processorObject->checkConfig();
103 * Get payment processor by it's ID.
107 * @return \CRM_Core_Payment|NULL
108 * @throws \CiviCRM_API3_Exception
110 public function getById($id) {
112 return new \
CRM_Core_Payment_Manual();
114 $processor = civicrm_api3('payment_processor', 'getsingle', array('id' => $id, 'is_test' => NULL));
115 return self
::getByProcessor($processor);
119 * @param string $name
120 * @param bool $is_test
122 * @return \CRM_Core_Payment|NULL
123 * @throws \CiviCRM_API3_Exception
125 public function getByName($name, $is_test) {
126 $processor = civicrm_api3('payment_processor', 'getsingle', array('name' => $name, 'is_test' => $is_test));
127 return self
::getByProcessor($processor);
131 * Flush processors from static cache.
133 * This is particularly used for tests.
135 public function flushProcessors() {
136 $this->cache
= array();
137 \CRM_Financial_BAO_PaymentProcessor
::getAllPaymentProcessors('all', TRUE);
138 \CRM_Financial_BAO_PaymentProcessor
::getAllPaymentProcessors('live', TRUE);
139 \CRM_Financial_BAO_PaymentProcessor
::getAllPaymentProcessors('test', TRUE);
143 * Sometimes we want to instantiate a processor object when no valid instance exists (eg. when uninstalling a
146 * This function does not load instance specific details for the processor.
148 * @param string $className
150 * @return \Civi\Payment\CRM_Core_Payment|NULL
151 * @throws \CiviCRM_API3_Exception
153 public function getByClass($className) {
154 return $this->getByProcessor(array(
155 'class_name' => $className,