3 +--------------------------------------------------------------------+
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2019 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
30 * Given an argument list, invoke the appropriate CRM function
31 * Serves as a wrapper between the UserFrameWork and Core CRM
34 * @copyright CiviCRM LLC (c) 2004-2019
36 class CRM_Core_Invoke
{
39 * This is the main front-controller that integrates with the CMS. Any
40 * page-request that is sent to the CMS and intended for CiviCRM should
41 * be processed by invoke().
44 * The parts of the URL which identify the intended CiviCRM page
45 * (e.g. array('civicrm', 'event', 'register')).
47 * HTML. For non-HTML content, invoke() may call print() and exit().
50 public static function invoke($args) {
52 return self
::_invoke($args);
54 catch (Exception
$e) {
55 CRM_Core_Error
::handleUnhandledException($e);
60 * This is the same as invoke(), but it does *not* include exception
64 * The parts of the URL which identify the intended CiviCRM page
65 * (e.g. array('civicrm', 'event', 'register')).
67 * HTML. For non-HTML content, invoke() may call print() and exit().
69 public static function _invoke($args) {
70 if ($args[0] !== 'civicrm') {
73 // CRM-15901: Turn off PHP errors display for all ajax calls
74 if (CRM_Utils_Array
::value(1, $args) == 'ajax' || CRM_Utils_Array
::value('snippet', $_REQUEST)) {
75 ini_set('display_errors', 0);
78 if (!defined('CIVICRM_SYMFONY_PATH')) {
79 // Traditional Civi invocation path
81 self
::hackMenuRebuild($args);
83 $item = self
::getItem($args);
84 return self
::runItem($item);
87 // Symfony-based invocation path
88 require_once CIVICRM_SYMFONY_PATH
. '/app/bootstrap.php.cache';
89 require_once CIVICRM_SYMFONY_PATH
. '/app/AppKernel.php';
90 $kernel = new AppKernel('dev', TRUE);
91 $kernel->loadClassCache();
92 $response = $kernel->handle(Symfony\Component\HttpFoundation\Request
::createFromGlobals());
93 if (preg_match(':^text/html:', $response->headers
->get('Content-Type'))) {
94 // let the CMS handle the trappings
95 return $response->getContent();
105 * Hackish support /civicrm/menu/rebuild
108 * List of path parts.
111 public static function hackMenuRebuild($args) {
112 if (['civicrm', 'menu', 'rebuild'] == $args ||
['civicrm', 'clearcache'] == $args) {
113 // ensure that the user has a good privilege level
114 if (CRM_Core_Permission
::check('administer CiviCRM')) {
115 self
::rebuildMenuAndCaches();
116 CRM_Core_Session
::setStatus(ts('Cleared all CiviCRM caches (database, menu, templates)'), ts('Complete'), 'success');
118 return CRM_Utils_System
::redirect();
121 CRM_Core_Error
::fatal('You do not have permission to execute this url');
127 * Perform general setup.
130 * List of path parts.
133 public static function init($args) {
134 // first fire up IDS and check for bad stuff
135 $config = CRM_Core_Config
::singleton();
137 // also initialize the i18n framework
138 require_once 'CRM/Core/I18n.php';
139 $i18n = CRM_Core_I18n
::singleton();
143 * Determine which menu $item corresponds to $args
146 * List of path parts.
147 * @return array; see CRM_Core_Menu
149 public static function getItem($args) {
150 if (is_array($args)) {
151 // get the menu items
152 $path = implode('/', $args);
157 $item = CRM_Core_Menu
::get($path);
159 // we should try to compute menus, if item is empty and stay on the same page,
160 // rather than compute and redirect to dashboard.
162 CRM_Core_Menu
::store(FALSE);
163 $item = CRM_Core_Menu
::get($path);
170 * Given a menu item, call the appropriate controller and return the response
174 * @return string, HTML
176 public static function runItem($item) {
177 $ids = new CRM_Core_IDS();
180 $config = CRM_Core_Config
::singleton();
181 if ($config->userFramework
== 'Joomla' && $item) {
182 $config->userFrameworkURLVar
= 'task';
184 // joomla 1.5RC1 seems to push this in the POST variable, which messes
186 unset($_POST['option']);
187 CRM_Core_Joomla
::sidebarLeft();
190 // set active Component
191 $template = CRM_Core_Smarty
::singleton();
192 $template->assign('activeComponent', 'CiviCRM');
193 $template->assign('formTpl', 'default');
196 // CRM-7656 - make sure we send a clean sanitized path to create printer friendly url
197 $printerFriendly = CRM_Utils_System
::makeURL(
198 'snippet', FALSE, FALSE,
199 CRM_Utils_Array
::value('path', $item)
201 $template->assign('printerFriendly', $printerFriendly);
203 if (!array_key_exists('page_callback', $item)) {
204 CRM_Core_Error
::debug('Bad item', $item);
205 CRM_Core_Error
::fatal(ts('Bad menu record in database'));
208 // check that we are permissioned to access this page
209 if (!CRM_Core_Permission
::checkMenuItem($item)) {
210 CRM_Utils_System
::permissionDenied();
214 // check if ssl is set
215 if (!empty($item['is_ssl'])) {
216 CRM_Utils_System
::redirectToSSL();
219 if (isset($item['title'])) {
220 CRM_Utils_System
::setTitle($item['title']);
223 if (isset($item['breadcrumb']) && !isset($item['is_public'])) {
224 CRM_Utils_System
::appendBreadCrumb($item['breadcrumb']);
228 if (!empty($item['page_arguments'])) {
229 $pageArgs = CRM_Core_Menu
::getArrayForPathArgs($item['page_arguments']);
232 $template = CRM_Core_Smarty
::singleton();
233 if (!empty($item['is_public'])) {
234 $template->assign('urlIsPublic', TRUE);
237 $template->assign('urlIsPublic', FALSE);
238 self
::statusCheck($template);
241 if (isset($item['return_url'])) {
242 $session = CRM_Core_Session
::singleton();
243 $args = CRM_Utils_Array
::value(
248 $session->pushUserContext(CRM_Utils_System
::url($item['return_url'], $args));
252 // WISHLIST: Refactor this. Instead of pattern-matching on page_callback, lookup
253 // page_callback via Civi\Core\Resolver and check the implemented interfaces. This
254 // would require rethinking the default constructor.
255 if (is_array($item['page_callback']) ||
strpos($item['page_callback'], ':')) {
256 $result = call_user_func(Civi\Core\Resolver
::singleton()->get($item['page_callback']));
258 elseif (strstr($item['page_callback'], '_Form')) {
259 $wrapper = new CRM_Utils_Wrapper();
260 $result = $wrapper->run(
261 CRM_Utils_Array
::value('page_callback', $item),
262 CRM_Utils_Array
::value('title', $item),
263 isset($pageArgs) ?
$pageArgs : NULL
267 $newArgs = explode('/', $_GET[$config->userFrameworkURLVar
]);
269 if (isset($pageArgs['mode'])) {
270 $mode = $pageArgs['mode'];
271 unset($pageArgs['mode']);
273 $title = CRM_Utils_Array
::value('title', $item);
274 if (strstr($item['page_callback'], '_Page') ||
strstr($item['page_callback'], '\\Page\\')) {
275 $object = new $item['page_callback']($title, $mode);
276 $object->urlPath
= explode('/', $_GET[$config->userFrameworkURLVar
]);
278 elseif (strstr($item['page_callback'], '_Controller') ||
strstr($item['page_callback'], '\\Controller\\')) {
279 $addSequence = 'false';
280 if (isset($pageArgs['addSequence'])) {
281 $addSequence = $pageArgs['addSequence'];
282 $addSequence = $addSequence ?
'true' : 'false';
283 unset($pageArgs['addSequence']);
285 $object = new $item['page_callback']($title, TRUE, $mode, NULL, $addSequence);
288 CRM_Core_Error
::fatal();
290 $result = $object->run($newArgs, $pageArgs);
293 CRM_Core_Session
::storeSessionObjects();
297 CRM_Core_Menu
::store();
298 CRM_Core_Session
::setStatus(ts('Menu has been rebuilt'), ts('Complete'), 'success');
299 return CRM_Utils_System
::redirect();
303 * This function contains the default action.
307 * @param $contact_type
308 * @param $contact_sub_type
311 public static function form($action, $contact_type, $contact_sub_type) {
312 CRM_Utils_System
::setUserContext(['civicrm/contact/search/basic', 'civicrm/contact/view']);
313 $wrapper = new CRM_Utils_Wrapper();
315 $properties = CRM_Core_Component
::contactSubTypeProperties($contact_sub_type, 'Edit');
317 $wrapper->run($properties['class'], ts('New %1', [1 => $contact_sub_type]), $action, TRUE);
320 $wrapper->run('CRM_Contact_Form_Contact', ts('New Contact'), $action, TRUE);
325 * Show status in the footer (admin only)
327 * @param CRM_Core_Smarty $template
329 public static function statusCheck($template) {
330 if (CRM_Core_Config
::isUpgradeMode() ||
!CRM_Core_Permission
::check('administer CiviCRM')) {
333 // always use cached results - they will be refreshed by the session timer
334 $status = Civi
::cache('checks')->get('systemStatusCheckResult');
335 $template->assign('footer_status_severity', $status);
336 $template->assign('footer_status_message', CRM_Utils_Check
::toStatusLabel($status));
340 * @param bool $triggerRebuild
341 * @param bool $sessionReset
345 public static function rebuildMenuAndCaches($triggerRebuild = FALSE, $sessionReset = FALSE) {
346 $config = CRM_Core_Config
::singleton();
347 $config->clearModuleList();
349 // also cleanup all caches
350 $config->cleanupCaches($sessionReset || CRM_Utils_Request
::retrieve('sessionReset', 'Boolean', CRM_Core_DAO
::$_nullObject, FALSE, 0, 'GET'));
352 CRM_Core_Menu
::store();
354 // also reset navigation
355 CRM_Core_BAO_Navigation
::resetNavigation();
357 // also cleanup module permissions
358 $config->cleanupPermissions();
360 // rebuild word replacement cache - pass false to prevent operations redundant with this fn
361 CRM_Core_BAO_WordReplacement
::rebuild(FALSE);
363 Civi
::service('settings_manager')->flush();
365 CRM_Core_Resources
::singleton()->flushStrings()->resetCacheCode();
366 CRM_Case_XMLRepository
::singleton(TRUE);
368 // also rebuild triggers if requested explicitly
371 CRM_Utils_Request
::retrieve('triggerRebuild', 'Boolean', CRM_Core_DAO
::$_nullObject, FALSE, 0, 'GET')
373 CRM_Core_DAO
::triggerRebuild();
375 CRM_Core_DAO_AllCoreTables
::reinitializeCache(TRUE);
376 CRM_Core_ManagedEntities
::singleton(TRUE)->reconcile();