Development.php — Matomo Analytics – Powerful, Privacy-First Insights for WordPress 5.8.2

matomo / app / core / Development.php

matomo / app / core Last commit date

API 3 months ago Access 3 months ago Application 3 months ago Archive 3 months ago ArchiveProcessor 3 months ago Archiver 2 years ago AssetManager 3 months ago Auth 6 months ago Category 6 months ago Changes 3 months ago CliMulti 1 year ago Columns 3 months ago Concurrency 3 months ago Config 3 months ago Container 3 months ago CronArchive 3 months ago DataAccess 3 months ago DataFiles 2 years ago DataTable 3 months ago Db 3 months ago DeviceDetector 1 year ago Email 2 years ago Exception 4 months ago Http 4 months ago Intl 3 months ago Log 2 years ago Mail 1 year ago Measurable 6 months ago Menu 3 months ago Metrics 3 months ago Notification 6 months ago Period 3 months ago Plugin 3 months ago Policy 3 months ago ProfessionalServices 1 year ago Report 1 year ago ReportRenderer 3 months ago Request 3 months ago Scheduler 3 months ago Segment 3 months ago Session 3 months ago Settings 3 months ago Tracker 3 months ago Translation 3 months ago Twig 1 year ago UpdateCheck 3 months ago Updater 4 months ago Updates 3 months ago Validators 1 year ago View 6 months ago ViewDataTable 3 months ago Visualization 1 year ago Widget 3 months ago .htaccess 2 years ago Access.php 3 months ago Archive.php 3 months ago ArchiveProcessor.php 4 months ago AssetManager.php 3 months ago Auth.php 6 months ago AuthResult.php 6 months ago BaseFactory.php 2 years ago Cache.php 2 years ago CacheId.php 4 months ago CliMulti.php 3 months ago Common.php 3 months ago Config.php 3 months ago Console.php 3 months ago Context.php 2 years ago Cookie.php 1 year ago CronArchive.php 3 months ago DI.php 3 months ago DataArray.php 5 months ago DataTable.php 3 months ago Date.php 3 months ago Db.php 3 months ago DbHelper.php 3 months ago Development.php 1 year ago ErrorHandler.php 6 months ago EventDispatcher.php 1 year ago ExceptionHandler.php 4 months ago FileIntegrity.php 3 months ago Filechecks.php 1 year ago Filesystem.php 3 months ago FrontController.php 4 months ago Http.php 4 months ago IP.php 1 year ago Log.php 3 months ago LogDeleter.php 1 year ago Mail.php 1 year ago Metrics.php 3 months ago NoAccessException.php 2 years ago Nonce.php 6 months ago Notification.php 6 months ago NumberFormatter.php 5 months ago Option.php 5 months ago Period.php 3 months ago Piwik.php 3 months ago Plugin.php 3 months ago Process.php 1 year ago Profiler.php 6 months ago ProxyHeaders.php 4 months ago ProxyHttp.php 5 months ago QuickForm2.php 3 months ago RankingQuery.php 5 months ago ReportRenderer.php 3 months ago Request.php 3 months ago Segment.php 3 months ago Sequence.php 6 months ago Session.php 3 months ago SettingsPiwik.php 3 months ago SettingsServer.php 1 year ago Singleton.php 2 years ago Site.php 4 months ago SiteContentDetector.php 3 months ago SupportedBrowser.php 2 years ago TCPDF.php 1 year ago Theme.php 1 year ago Timer.php 2 years ago Tracker.php 3 months ago Twig.php 3 months ago Unzip.php 1 year ago UpdateCheck.php 3 months ago Updater.php 3 months ago UpdaterErrorException.php 2 years ago Updates.php 3 months ago Url.php 3 months ago UrlHelper.php 3 months ago Version.php 3 months ago View.php 3 months ago bootstrap.php 1 year ago dispatch.php 2 years ago testMinimumPhpVersion.php 6 months ago

Development.php

170 lines

1	<?php
2
3	/**
4	* Matomo - free/libre analytics platform
5	*
6	* @link https://matomo.org
7	* @license https://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
8	*/
9	namespace Piwik;
10
11	use Exception;
12	use Piwik\Container\StaticContainer;
13	use Piwik\Log\LoggerInterface;
14	/**
15	* Development related checks and tools. You can enable/disable development using `./console development:enable` and
16	* `./console development:disable`. The intention of the development mode and this class is to support the developer
17	* as much as possible by doing some additional checks if the development mode is enabled. For instance if a developer
18	* has to register any class/method we can make sure whether they actually exist and if not display a useful error
19	* message. This helps the user to find for instance simple typos and makes sure it will actually work even if he
20	* forgets to test it.
21	*/
22	class Development
23	{
24	private static $isEnabled = null;
25	/**
26	* Returns `true` if development mode is enabled and `false` otherwise.
27	*
28	* @return bool
29	*/
30	public static function isEnabled()
31	{
32	if (is_null(self::$isEnabled)) {
33	self::$isEnabled = (bool) \Piwik\Config::getInstance()->Development['enabled'];
34	}
35	return self::$isEnabled;
36	}
37	/**
38	* Verifies whether a className of object implements the given method. It does not check whether the given method
39	* is actually callable (public).
40	*
41	* @param string\|object $classOrObject
42	* @param string $method
43	*
44	* @return bool true if the method exists, false otherwise.
45	*/
46	public static function methodExists($classOrObject, $method)
47	{
48	if (is_string($classOrObject)) {
49	return class_exists($classOrObject) && method_exists($classOrObject, $method);
50	}
51	return method_exists($classOrObject, $method);
52	}
53	/**
54	* Formats a method call depending on the given class/object and method name. It does not perform any checks whether
55	* does actually exists.
56	*
57	* @param string\|object $classOrObject
58	* @param string $method
59	*
60	* @return string Formatted method call. Example: "MyNamespace\MyClassname::methodName()"
61	*/
62	public static function formatMethodCall($classOrObject, $method)
63	{
64	if (is_object($classOrObject)) {
65	$classOrObject = get_class($classOrObject);
66	}
67	return $classOrObject . '::' . $method . '()';
68	}
69	/**
70	* Checks whether the given method is actually callable on the given class/object if the development mode is
71	* enabled. En error will be triggered if the method does not exist or is not callable (public) containing a useful
72	* error message for the developer.
73	*
74	* @param string\|object $classOrObject
75	* @param string $method
76	* @param string $prefixMessageIfError You can prepend any string to the error message in case the method is not
77	* callable.
78	*/
79	public static function checkMethodIsCallable($classOrObject, $method, $prefixMessageIfError)
80	{
81	if (!self::isEnabled()) {
82	return;
83	}
84	self::checkMethodExists($classOrObject, $method, $prefixMessageIfError);
85	if (!self::isCallableMethod($classOrObject, $method)) {
86	self::error($prefixMessageIfError . ' "' . self::formatMethodCall($classOrObject, $method) . '" is not callable. Please make sure to method is public');
87	}
88	}
89	/**
90	* Checks whether the given method is actually callable on the given class/object if the development mode is
91	* enabled. En error will be triggered if the method does not exist or is not callable (public) containing a useful
92	* error message for the developer.
93	*
94	* @param string\|object $classOrObject
95	* @param string $method
96	* @param string $prefixMessageIfError You can prepend any string to the error message in case the method is not
97	* callable.
98	*/
99	public static function checkMethodExists($classOrObject, $method, $prefixMessageIfError)
100	{
101	if (!self::isEnabled()) {
102	return;
103	}
104	if (!self::methodExists($classOrObject, $method)) {
105	self::error($prefixMessageIfError . ' "' . self::formatMethodCall($classOrObject, $method) . '" does not exist. Please make sure to define such a method.');
106	}
107	}
108	/**
109	* Verify whether the given method actually exists and is callable (public).
110	*
111	* @param string\|object $classOrObject
112	* @param string $method
113	* @return bool
114	*/
115	public static function isCallableMethod($classOrObject, $method)
116	{
117	if (!self::methodExists($classOrObject, $method)) {
118	return \false;
119	}
120	$reflection = new \ReflectionMethod($classOrObject, $method);
121	return $reflection->isPublic();
122	}
123	/**
124	* Triggers an error if the development mode is enabled. Depending on the current environment / mode it will either
125	* log the given message or throw an exception to make sure it will be displayed in the Piwik UI.
126	*
127	* @param string $message
128	* @throws Exception
129	*/
130	public static function error($message)
131	{
132	if (!self::isEnabled()) {
133	return;
134	}
135	$message .= ' (This error is only shown in development mode)';
136	if (\Piwik\SettingsServer::isTrackerApiRequest() \|\| \Piwik\Common::isPhpCliMode()) {
137	StaticContainer::get(LoggerInterface::class)->error($message, ['ignoreInScreenWriter' => \true]);
138	} else {
139	throw new Exception($message);
140	}
141	}
142	public static function getMethodSourceCode($className, $methodName)
143	{
144	$method = new \ReflectionMethod($className, $methodName);
145	$file = new \SplFileObject($method->getFileName());
146	$offset = $method->getStartLine() - 1;
147	$count = $method->getEndLine() - $method->getStartLine() + 1;
148	$fileIterator = new \LimitIterator($file, $offset, $count);
149	$methodCode = "\n " . $method->getDocComment() . "\n";
150	foreach ($fileIterator as $line) {
151	$methodCode .= $line;
152	}
153	$methodCode .= "\n";
154	return $methodCode;
155	}
156	public static function getUseStatements($className)
157	{
158	$class = new \ReflectionClass($className);
159	$file = new \SplFileObject($class->getFileName());
160	$fileIterator = new \LimitIterator($file, 0, $class->getStartLine());
161	$uses = array();
162	foreach ($fileIterator as $line) {
163	if (preg_match('/(\\s*)use (.+)/', $line, $match)) {
164	$uses[] = trim($match[2]);
165	}
166	}
167	return $uses;
168	}
169	}
170