summaryrefslogtreecommitdiffstats
path: root/user_guide_src/source/general/managing_apps.rst
blob: 3ca0e03a731ee2b842a62d35aeec2b912c190734 (plain)
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
##########################
Managing your Applications
##########################

By default it is assumed that you only intend to use CodeIgniter to
manage one application, which you will build in your *application/*
directory. It is possible, however, to have multiple sets of
applications that share a single CodeIgniter installation, or even to
rename or relocate your application directory.

Renaming the Application Directory
==================================

If you would like to rename your application directory you may do so
as long as you open your main index.php file and set its name using
the ``$application_folder`` variable::

	$application_folder = 'application';

Relocating your Application Directory
=====================================

It is possible to move your application directory to a different
location on your server than your web root. To do so open
your main index.php and set a *full server path* in the
``$application_folder`` variable::

	$application_folder = '/path/to/your/application';

Running Multiple Applications with one CodeIgniter Installation
===============================================================

If you would like to share a common CodeIgniter installation to manage
several different applications simply put all of the directories located
inside your application directory into their own sub-directory.

For example, let's say you want to create two applications, named "foo"
and "bar". You could structure your application directories like this::

	applications/foo/
	applications/foo/config/
	applications/foo/controllers/
	applications/foo/errors/
	applications/foo/libraries/
	applications/foo/models/
	applications/foo/views/
	applications/bar/
	applications/bar/config/
	applications/bar/controllers/
	applications/bar/errors/
	applications/bar/libraries/
	applications/bar/models/
	applications/bar/views/

To select a particular application for use requires that you open your
main index.php file and set the ``$application_folder`` variable. For
example, to select the "foo" application for use you would do this::

	$application_folder = 'applications/foo';

.. note:: Each of your applications will need its own index.php file
	which calls the desired application. The index.php file can be named
	anything you want.