-
Notifications
You must be signed in to change notification settings - Fork 0
/
libraries.php
125 lines (115 loc) · 6.32 KB
/
libraries.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
<?php
/**
* Lithium: the most rad php framework
*
* @copyright Copyright 2011, Union of RAD (http://union-of-rad.org)
* @license http://opensource.org/licenses/bsd-license.php The BSD License
*/
/**
* The libraries file is where you configure the various plugins, frameworks, and other libraries
* to be used by your application, including your application itself. This file also defines some
* global constants used to tell Lithium where to find your application and support libraries
* (including Lithium itself). It uses the `Libraries` class to add configurations for the groups of
* classes used in your app.
*
* In Lithium, a _library_ is any collection of classes located in a single base directory, which
* all share the same class-to-file naming convention, and usually a common class or namespace
* prefix. While all collections of classes are considered libraries, there are two special types of
* libraries:
*
* - **Applications**: Applications are libraries which follow the organizational conventions that
* Lithium defines for applications (see `Libraries::locate()` and `Libraries::paths()`), and
* which also include a web-accessible document root (i.e. the `webroot/` folder), and can
* dispatch HTTP requests (i.e. through `webroot/index.php`).
*
* - **Plugins**: Plugins are libraries which generally follow the same organizational conventions
* as applications, but are designed to be used within the context of another application. They
* _may_ include a public document root for supporting assets, but this requires a symlink from
* `libraries/<plugin-name>/webroot` to `<app-name>/webroot/<plugin-name>` (recommended for
* production), or a media filter to load plugin resources (see `/config/bootstrap/media.php`).
*
* Note that a library can be designed as both an application and a plugin, but this requires some
* special considerations in the bootstrap process, such as removing any `require` statements, and
* conditionally defining the constants below.
*
* By default, libraries are stored in the base `/libraries` directory, or in the
* application-specific `<app-name>/libraries` directory. Libraries can be loaded from either place
* without additional configuration, but note that if the same library is in both directories, the
* application-specific `libraries` directory will override the global one.
*
* The one exception to this is the _primary_ library, which is an application configured with
* `'default' => true` (see below); this library uses the `LITHIUM_APP_PATH` constant (also defined
* below) as its path. Note, however, that any library can be overridden with an arbitrary path by
* passing the `'path'` key to its configuration. See `Libraries::add()` for more options.
*
* @see lithium\core\Libraries
*/
/**
* This is the path to your application's directory. It contains all the sub-folders for your
* application's classes and files. You don't need to change this unless your webroot folder is
* stored outside of your app folder.
*/
define('LITHIUM_APP_PATH', dirname(dirname(__DIR__)));
/**
* This is the path to the class libraries used by your application, and must contain a copy of the
* Lithium core. By default, this directory is named `libraries`, and resides in the same
* directory as your application. If you use the same libraries in multiple applications, you can
* set this to a shared path on your server.
*/
define('LITHIUM_LIBRARY_PATH', LITHIUM_APP_PATH . '/libraries');
/**
* Locate and load Lithium core library files. Throws a fatal error if the core can't be found.
* If your Lithium core directory is named something other than `lithium`, change the string below.
*/
if (!include LITHIUM_LIBRARY_PATH . '/lithium/core/Libraries.php') {
$message = "Lithium core could not be found. Check the value of LITHIUM_LIBRARY_PATH in ";
$message .= __FILE__ . ". It should point to the directory containing your ";
$message .= "/libraries directory.";
throw new ErrorException($message);
}
use lithium\core\Libraries;
/**
* Optimize default request cycle by loading common classes. If you're implementing custom
* request/response or dispatch classes, you can safely remove these. Actually, you can safely
* remove them anyway, they're just there to give slightly you better out-of-the-box performance.
*/
require LITHIUM_LIBRARY_PATH . '/lithium/core/Object.php';
require LITHIUM_LIBRARY_PATH . '/lithium/core/StaticObject.php';
require LITHIUM_LIBRARY_PATH . '/lithium/util/Collection.php';
require LITHIUM_LIBRARY_PATH . '/lithium/util/collection/Filters.php';
require LITHIUM_LIBRARY_PATH . '/lithium/util/Inflector.php';
require LITHIUM_LIBRARY_PATH . '/lithium/util/String.php';
require LITHIUM_LIBRARY_PATH . '/lithium/core/Adaptable.php';
require LITHIUM_LIBRARY_PATH . '/lithium/core/Environment.php';
require LITHIUM_LIBRARY_PATH . '/lithium/net/Message.php';
require LITHIUM_LIBRARY_PATH . '/lithium/net/http/Message.php';
require LITHIUM_LIBRARY_PATH . '/lithium/net/http/Media.php';
require LITHIUM_LIBRARY_PATH . '/lithium/net/http/Request.php';
require LITHIUM_LIBRARY_PATH . '/lithium/net/http/Response.php';
require LITHIUM_LIBRARY_PATH . '/lithium/net/http/Route.php';
require LITHIUM_LIBRARY_PATH . '/lithium/net/http/Router.php';
require LITHIUM_LIBRARY_PATH . '/lithium/action/Controller.php';
require LITHIUM_LIBRARY_PATH . '/lithium/action/Dispatcher.php';
require LITHIUM_LIBRARY_PATH . '/lithium/action/Request.php';
require LITHIUM_LIBRARY_PATH . '/lithium/action/Response.php';
require LITHIUM_LIBRARY_PATH . '/lithium/template/View.php';
require LITHIUM_LIBRARY_PATH . '/lithium/template/view/Renderer.php';
require LITHIUM_LIBRARY_PATH . '/lithium/template/view/Compiler.php';
require LITHIUM_LIBRARY_PATH . '/lithium/template/view/adapter/File.php';
require LITHIUM_LIBRARY_PATH . '/lithium/storage/Cache.php';
require LITHIUM_LIBRARY_PATH . '/lithium/storage/cache/adapter/Apc.php';
/**
* Add the Lithium core library. This sets default paths and initializes the autoloader. You
* generally should not need to override any settings.
*/
Libraries::add('lithium');
/**
* Add the application. You can pass a `'path'` key here if this bootstrap file is outside of
* your main application, but generally you should not need to change any settings.
*/
Libraries::add('app', array('default' => true));
/**
* Add some plugins:
*/
// Libraries::add('li3_docs');
?>