A note about the 127.0.0.1 IP address and localhost. This is also known as the server “Home”. These terms are familiar to geeks<\/a>, as you can see in the geek t-shirt represented in the figure below.<\/p>\n Let’s come back to the Apache default home page. This page is a plain html page, that is a normal text file that can be edited with any text editor (more on text editors in the next chapter) including for example the nano shell editor that was discussed in section 2-3<\/a>. This text file, whose file name ends with a “.html” extension, is located on your Linux server and was created by the installer at the time of Apache installation.<\/p>\n The full name of this file is “index.html”. This is a file name you will become very familiar with. More on this in a moment.<\/p>\n When you visit localhost, the index.html file is loaded to the browser. The browser interprets the html code of the file, looking for example for parts of text that should be formatted and rendered in a particular way, graphically and for images to be included in the page. The browser then shows you a nicely formatted page.<\/p>\n In the default Apache page for instance, the “It Works!” part is rendered in bold and is on a line of it’s own with respect to the rest of the text in the page, as shown in figure 2-5-2 of the previous section<\/a>.<\/p>\n How text formatting and page layouts can be achieved by using the HTML markup language will be discussed in depth in the next chapter.<\/p>\n Instead, we will now focus on our index.html as a file of the computer. Where is this index.html file, show by default on visiting the server’s Home\/localhost\/127.0.0.1, located in the Linux filesystem?<\/p>\n The index.html is located in a special directory of the filesystem called the Web Root<\/strong> or Document Root<\/strong>. The path of the web root directory is specified in one of the Apache configuration files, located at:<\/p>\n \/etc\/apache2\/sites-enabled\/000-default<\/p>\n After installing Apache you can view the contents of this file on your system by running:<\/p>\n cat \/etc\/apache2\/sites-enabled\/000-default.conf <\/p>\n In recent versions of Apache, the default web root directory, that contains the index.html file, is as follows:<\/p>\n \/var\/www\/html <\/p>\n The path was \/var\/www in older versions of Apache.<\/p>\n so the index.html file’s path is:<\/p>\n \/var\/www\/html\/index.html<\/p>\n If we wanted to, we could change the web root directory by editing the configuration file. We need to use the sudo command and edit the file as root, as Apache configuration files belong to root. Therefore, as a normal user, you will not have permission to edit the configuration files.<\/p>\n andrea@ubuntu:~$ sudo nano -w \/etc\/apache2\/sites-enabled\/000-default.conf<\/p>\n We could then change the DocumentRoot’s directory path, save the file with Ctrl + o, exit nano with Ctrl + x, restart the Apache web server so as to re-load the edited configuration file and get the modification to work:<\/p>\n andrea@ubuntu:~$ sudo service apache2 restart<\/p>\n or<\/p>\n andrea@ubuntu:~$ \/etc\/init.d\/apache2 restart<\/p>\n However there is no special need to change the default DocumentRoot path, the default directory \/var\/www\/html is just fine for our purposes.<\/p>\n We would now like to turn our web server in the course’s web server, where students can each have an account that they can use to practice their Bioinformatics web development skills and then, at the end of the course, build their own Bioinformatics web application.<\/p>\n An account for each student can easily be created with the “adduser” shell command that was already discussed in a previous section<\/a>.<\/p>\n We then have to enable the so called “userdir” directories Apache functionality, so that each user will automatically be able to publish web contents at a public address. Each user will have a personal folder that will act as it’s personal “Document Root” directory.<\/p>\n We will configure Apache so that each user will have a public web address accessible at web URL of this kind:<\/p>\n http:\/\/web-server-ip\/~username<\/p>\n Please note the tilde ~ that precedes the username and indeed needs to be included in the URL for the address to work.<\/p>\n The Document Root of each user will be a directory named:<\/p>\n public_html<\/p>\n located in each user’s home directory, at \/home\/username\/public_html<\/p>\n Everything in this directory will be visible at the URL given above, for each user.<\/p>\n Here’s the full procedure to enable this setup:<\/p>\n We call the “a2enmod” shell command (A<\/strong>pache2<\/strong> En<\/strong>able Mod<\/strong>ule) with the name of the module we want to activate as an argument. We need to activate the “userdir” Apache module.<\/p>\n andrea@ubuntu:~$ sudo a2enmod userdir<\/p>\n Please note that disabling Apache2 modules is done instead with the “a2dismod” shell command.<\/p>\n Create the public_html web directories in the user directories. Each user may create it’s own by going to his home directory with:<\/p>\n username@ubuntu:~$ cd<\/p>\n and then typing:<\/p>\n username@ubuntu:~$ mkdir public_html<\/p>\n Restart apache:<\/p>\n andrea@ubuntu:~$ sudo service apache2 restart<\/p>\n The public_html directories can now be visited with the browser at:<\/p>\n http:\/\/web-server-ip\/~username<\/p>\n In order for this to work, however, make sure that the users directories (\/home\/username) have a 755 permission, otherwise you may get a Forbidden message on trying to visit the users personal web directories at the address above because Apache will be unable to read\/search into them so as to reach the public_html directories.<\/p>\n Still a little more configuration editing in order to enable the execution of PHP scripts in the user’s public_html directories.<\/p>\n First run the following command to check out the name of the current php conf file.<\/p>\n andrea@ubuntu:~$ ls \/etc\/apache2\/mods-enabled\/ | grep php<\/p>\n You may get an output like this:<\/p>\n php7.0.conf We are interested in the file that ends in .conf, in this case this would be php7.0.conf.<\/p>\n Let’s edit this file:<\/p>\n andrea@ubuntu:~$ sudo nano -w \/etc\/apache2\/mods-enabled\/php7.0.conf<\/p>\n As PHP in user directories is disabled by default, we need to enable this feature by commenting or deleting the following part of the file:<\/p>\n <ifModule mod_userdir.c> Commenting means adding a # before each line we wish to “inactivate”. The commented version of the code above would be:<\/p>\n #<ifModule mod_userdir.c> As usual, save the file (ctrl + o) and exit nano (ctrl + x).<\/p>\n We can now restart the Apache web server so that the configuration files are reloaded and the modifications can become effective:<\/p>\n andrea@ubuntu:~$ sudo service apache2 restart<\/p>\n Each user can now create an index.php file in his public_html directory:<\/p>\n andrea@ubuntu:~$ nano -w \/home\/username\/public_html\/index.php<\/p>\n write something inside:<\/p>\n save the file with Ctrl + o, exit nano with Ctrl + x<\/p>\n The result can be seen by visiting the user’s home URL at:<\/p>\n http:\/\/web-server-ip\/~username<\/p>\n or, if working locally:<\/p>\n http:\/\/localhost\/~username<\/p>\n If you have installed Linux on a machine that you will use exclusively, for example your laptop, there is no need to activate the userdir module. You can work directly at DocumentRoot, in the \/var\/www\/html folder (being the system administrator comes with some privileges). in this case we invite you, as a first exercise, to edit the default Apache index.html file:<\/p>\n andrea@ubuntu:~$ sudo nano -w \/var\/www\/html\/index.html<\/p>\n If you followed us up to this point and succeeded in having your first index.html page online, we expect you to post a success message below to let us know!<\/p>\n Having published online the first Hello World message is great, however a few more things need to be learned in order to build a nice web page or maybe a full website. We will learn all the relevant skills in the next chapter: Your first webpage, Learning HTML and CSS<\/a>.<\/p>\n![\"A](\"http:\/\/www.cellbiol.com\/bioinformatics_web_development\/wp-content\/uploads\/2017\/01\/localhost_t-shirt.jpeg\")
<\/a>Editing Apache configuration files<\/h2>\n
![\"The](\"http:\/\/www.cellbiol.com\/bioinformatics_web_development\/wp-content\/uploads\/2017\/01\/DocumentRoot_directive_iin_apache_configuration.png\")
<\/a>Using the UserDir Apache module to enable individual web development accounts for server’s users<\/h2>\n
Enabling PHP for users web directories<\/h2>\n
\nphp7.0.load<\/p>\n
\n<Directory \/home\/*\/public_html>
\nphp_admin_value engine Off
\n<\/Directory>
\n<\/ifModule><\/p>\n
\n# <Directory \/home\/*\/public_html>
\n# php_admin_value engine Off
\n# <\/Directory>
\n#<\/ifModule><\/p>\nTesting the setup<\/h2>\n
\r\n\r\n<\/code><\/pre>\n