brazell/wordpress bible

21

CHAPTER

Installing and Configuring WordPress

IN THIS CHAPTERSystem requirements

Choosing a Web server

Installing WordPress

WordPress is one of the simplest open source blog platforms to install. It has long bragged about its famous “five-minute install.” In fact, installing WordPress can take much less than five min-

utes. The most time-consuming part is the creation of a database for WordPress to use. This process can be near instantaneous if you’re a power user who can script the database creation, or a minute or two if a Web host control panel login is required.

Most Web servers are already set up out of the box to handle WordPress. If you have PHP 4.3 or better and MySQL 4.1.2 or better, then you are set to go. You can skip ahead to the part of this chapter that deals directly with handling the installation of WordPress.

If you are starting from scratch with your own server that doesn’t have the required PHP scripting language and MySQL database build, or if you have to install the Apache or other Web server, then read on.

TipAt this time, the most stable version of PHP is PHP 5.3.1. MySQL is stable at MySQL 5.1.36. n

NotePHP 4 reached its end of life on August 8, 2008, and is no longer supported by the PHP project. Quality hosts will not support it and though some still have it installed, I recommend avoiding hosts who do. n

06_568132-ch02.indd 2106_568132-ch02.indd 21 1/7/10 8:23 PM1/7/10 8:23 PM

Part I: Getting Started with WordPress

22

System RequirementsThe developers of WordPress have gone to great lengths to make WordPress compatible with as many platforms as it can. To that end, it can run on Linux, Windows, and Mac OS X. The only requirement is the PHP scripting language and a Web server. The recommended system essentials are PHP 5, MySQL 5, and Apache 2 on a Unix-variant operating system such as the ones most hosting companies provide in their Linux packages.

NoteThe minimum requirements for WordPress are PHP 4.3 and MySQL 4.1.2. However, PHP 5 will provide a richer experience as a developer. If your host does not support PHP 5, contact them and ask them to. n

The foundational building blocks of WordPress are the PHP scripting language and the MySQL database. Though it is technically possible to run WordPress on a different database than MySQL, it is impossible to run WordPress without PHP.

With the assumption that the lowest common denominator and lowest barrier to technical entry translates into a larger, more broad-based market share, WordPress developers have strived to be compatible with the majority of hosts of the hosting market. To that end, the minimum require-ments for WordPress 2.9 are PHP 4.3 and MySQL 4.1.2.

For optimal WordPress performance, edit your php.ini file (usually located at /etc/php.ini on Linux servers) and set (edit) the configurations to match those shown here:

memory_limit = 8M

upload_max_filesize = 8M

display_errors = Off

If you don’t know where your php.ini configuration file is, you can create a small PHP configu-ration file on your site. Call it phpinfo.php, type <?php phpinfo() ?>, and save the file. Load it into your browser and you should see a descriptive configuration page describing your PHP setup, as shown in Figure 2.1. The location of the PHP configuration file is listed under Loaded Configuration File.

Perhaps the most important area for system optimization is the MySQL database, at large scale. Some of the most intensive activity in the WordPress system architecture occurs here. Out of the box, MySQL is unoptimized. It works well only when blogs are small. After that, it begins to bog down. For a blog with medium-sized traffic, consider adding (or editing if needed) the following directives:


Chapter 2: Installing and Configuring WordPress

23

key_buffer = 32M

max_allowed_packet = 16M

thread_stack = 128K

thread_cache_size = 8

tmp_table_size = 64M

max_heap_table_size = 64M

query_cache_limit = 1M

query_cache_size = 32M

log_slow_queries = /var/log/mysql/mysql-slow.log

long_query_time = 2

FIGURE 2.1

The PHP configuration file is useful for finding out where the php.ini file is located.

NoteThis MySQL configuration is a suggestion for a blog with medium-sized traffic. You might need to modify your configuration based on hardware, traffic, or network bandwidth. n



24

Choosing a Web ServerIn most cases, the choice of Web server is something that is pretty standard. Most Web hosts pro-vide Linux hosting with Apache as the configured Web server. In most cases, the choice is auto-matic because it is the Web server that comes with virtually every distribution of Linux and is turned on, almost universally, by default.

With rare exception, these hosts are perfectly fine out of the box. Little additional configuration is needed to run a small blog. However, you should be a little cautious and ensure that the host has the minimum software requirements (PHP 4.3 and MySQL 4.1.2) and that they have the mod_rewrite Apache module configured. Again, almost universally, it is.

Sometimes, however, circumstances such as scaling, business, or corporate requirements prevent the use of open source Web servers. For example, a corporation may have a strategic business alli-ance with Microsoft and be locked in to using Internet Information Services (IIS), the Microsoft Web server product. In these cases, the minimum requirement of PHP 4.3 and MySQL 4.1.2 still exists, but the means for configuring the Web server might be slightly different.

CautionIIS causes problems with WordPress permalinks that require the Apache-only mod_rewrite module. Though there are some hackish solutions, these problems are an expected by-product of using this server platform. n

ApacheApache is an open source Web server that comes bundled with most Linux distributions. It is, by far, the most commonly used Web server on the Internet, and WordPress was designed perfectly for it. There is no minimum requirement for WordPress and Apache. The oldest still-used version of Apache is Apache 1.3 and it works functionally as well as Apache 2.2, which is the most stable.

NoteIt is assumed, throughout this book, that you are using Apache on Linux as your Web server. Also, unless other-wise noted, it is assumed that you control your own server and are not on a shared host. Shared hosting users should consult with their hosting provider to implement any system-level changes suggested in this book. n

Sean Walberg, a senior network engineer writing for IBM (www.ibm.com/developerworks/linux/library/l-tune-lamp-2.html), suggests the following settings as an optimal con-figuration for Apache.

StartServers = 50

MinSpareServers = 15

MaxSpareServers = 30

MaxClients = 225

MaxRequestsPerChild = 4000



25

LighttpdLighttpd (pronounced lighty) is a Web server that is popular among high-performance Web appli-cations such as YouTube and Wikipedia. It was also used for some time by WordPress.com and Gravatar, another product owned by Automattic.

Lighttpd is an excellent, free, open source alternative to Apache and supports FastCGI, an open protocol that allows multiple persistent connections to the Web server. On high-capacity, or high-traffic, Web sites, the capability to remove the overhead that comes from starting and finish-ing a Web server process can buy tons of server CPU (central processing unit) cycles, energy, and load. Lighttpd runs on both Linux variants (including Mac OS X) as well as Windows.

However, this fast and efficient Web server does not come without limitations. Lighttpd poses some challenges when it comes to permalinks and the traditionally used mod_rewrite module for Apache. One suggested solution is to edit the Lighttpd configuration file (usually found on a Linux box in /etc/lightppd/lightppd.conf) by adding the code shown in Listing 2.1.

LISTING 2.1

Suggested configuration for Lighttpd to handle WordPress permalinks

server.modules += (“mod_rewrite”)$HTTP[“host”] =~ “(www.)?example.com” (url.rewrite-once = ( “^/(.*)\.(.+)$” => “$0”, “^/(.+)/?$” => “/index.php/$1”,))

The code in Listing 2.1 says in plain English that Lighttpd will enable its own mod_rewrite module, and if a request comes to the Web server for the domain example.com, it will try to ful-fill rewrite rules in a way that WordPress expects it to.

LitespeedLitespeed is a commercially available Web server that has both free and paid versions. In most cases, the free version should suffice for WordPress; however, the paid version provides a variety of other features, such as an enhanced number of unlimited connections (the free version allows up to 150).

It is a drop-in replacement for Apache and does virtually everything Apache does, including using .htaccess and mod_rewrite rules. It is currently used at WordPress.com.



26

NginxA small and highly undocumented Web server, Nginx is a hyper-fast Web server that is light-weight, supports virtual hosts, and contains a rewrite module. WordPress.com uses it in front of their Litespeed servers. To use Nginx to serve PHP-generated pages directly, you must have a FastCGI handler installed. Plenty of FastCGI libraries are available, and PHP provides one if it is compiled with that support.

A sample configuration for a WordPress site might look like the code shown in Listing 2.2.

LISTING 2.2

A sample virtual host configuration

server { listen 12.34.56.78:80; # your server’s public IP address server_name example.com; # your domain name location / { root /home/example.com; # absolute path to your WordPress install index index.php index.html index.htm; # this serves static files that exist without running other rewrite

tests if (-f $request_filename) { expires 30d; break; } # this sends all non-existing file or directory requests to index.php if (!-e $request_filename) { rewrite ^(.+)$ /index.php?q=$1 last; } } location ~ \.php$ { fastcgi_pass localhost:53217; # port where FastCGI processes were

spawned fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /home/example.com$fastcgi_script_

name; # same path as above fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; fastcgi_param SCRIPT_NAME $fastcgi_script_name; fastcgi_param REQUEST_URI $request_uri; fastcgi_param DOCUMENT_URI $document_uri; fastcgi_param DOCUMENT_ROOT $document_root; fastcgi_param SERVER_PROTOCOL $server_protocol; fastcgi_param GATEWAY_INTERFACE CGI/1.1;



27

fastcgi_param SERVER_SOFTWARE nginx/$nginx_version; fastcgi_param REMOTE_ADDR $remote_addr; fastcgi_param REMOTE_PORT $remote_port; fastcgi_param SERVER_ADDR $server_addr; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_NAME $server_name; # required if PHP was built with --enable-force-cgi-redirect fastcgi_param REDIRECT_STATUS 200; }}

Internet Information ServicesBecause PHP can be loaded into the Microsoft server product, Internet Information Services (IIS), WordPress can be run on it. IIS is not the optimal solution, but it works in scenarios where other server products are not available or permitted. IIS is bundled with Microsoft Server products as part of Active Directory.

The trickiest issues with WordPress on IIS are permalinks. There is no mod_rewrite module available for IIS, though there are a couple of options, including commercial modules. One built-in option requires a modification to your php.ini file and enables you to use user-friendly perma-links at the expense of requiring index.php in the permalink. To make this change, open php.ini in Notepad and add (or edit if it exists or is commented with a preceding semicolon) the fol-lowing settings:

;cgi.fix_pathinfo = 0

cgi.fix_pathinfo = 1

TipMaking the PATH_INFO fix shown here is helpful for allowing friendly permalinks. Unlike Apache solutions, which might show a friendly permalink as http://example.com/hello-world instead of http://example.com/?p=31, the IIS PATH_INFO fix only allows permalinks with index.php, such as http://example.com/index.php/hello-world. To implement Apache-like mod_rewrite effects, third-party modules like the ISAPI_Rewrite module are required. You can purchase ISAPI_Rewrite at www.helicontech.com/order/#isapi_rewrite. n

NoteIIS 7.0, which ships with Windows 7 and can be installed on earlier versions of Microsoft Windows Server, supports a new URL Rewrite module, aptly named URLRewrite. WordPress supports rewriting with this module if available. For more information on URLRewrite, see http://blogs.iis.net/thomad/archive/2008/05/30/now-available-url-rewriter-tech-preview-1.aspx. n



28

Optional modulesYou should consider a few optional modules when getting your Web server and PHP build ready for WordPress use. These will provide you and your readers with the best possible experience with WordPress and will ensure that you have an efficient blogging platform.

Apache mod_rewriteIn most standard Linux, Apache, MySQL, and PHP (LAMP) installs, Apache comes prebuilt with mod_rewrite. However, if you’re unsure, you can verify it using the httpd command from the Linux command line (depending on the distribution of Linux, you might have to use apachectl or httpd instead). Type apache2ctl –M and press Enter to produce a listing of all shared and static modules that Apache is using. If you see rewrite_module in the list, as shown in Listing 2.3, then mod_rewrite is enabled.

LISTING 2.3

Verification that the rewrite_module is being used by Apache 2 on Ubuntu Linux 9

[root@wpbible ~]# apache2ctl -MLoaded Modules: core_module (static) mpm_prefork_module (static) http_module (static) so_module (static) env_module (shared) ext_filter_module (shared) mime_magic_module (shared) expires_module (shared) deflate_module (shared) headers_module (shared) usertrack_module (shared) setenvif_module (shared) userdir_module (shared) alias_module (shared) rewrite_module (shared) php5_module (shared) proxy_ajp_module (shared) python_module (shared) Syntax OK

If your Apache release happens to not have mod_rewrite installed, you can add it by recompiling Apache with the –enable-mod-rewrite flag or by using your package manager, such as apt-get, to add the Apache development tools. For apt-get, type apt-get install apache2-threaded-dev.



29

TipYum is a package manager provided by Red Hat Enterprise Linux, Fedora Core Linux, and CentOS Linux. apt-get is used by Debian-flavored Linux distributions, including Ubuntu. The instructions vary per Linux distribu-tion and depend on which package manager is being used to control software installed on the box. Alternatives include the yum install, apache2-devel, or the apt-get install, apache-threaded-dev. Consult the documentation for your Linux distribution if you’re unsure. n

On Ubuntu, the demonstration platform here, the previous command makes mod_rewrite avail-able to Apache but it won’t enable it. To do that, you need to make sure Apache knows how to load it. Follow these steps to create a symbolic link (better understood as a shortcut to Windows users) and restart the Web server:

1. From the Linux command line, type ln –s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled/rewrite.load. If you’re using Apache 1.3, simply replace apache2 with apache.

2. Type /etc/init.d/apache2 restart to make the changes take effect.

3. Type apache2ctl –M to verify that rewrite_module is in the list of available Apache modules.

The nice thing is that it is highly unlikely you will need to do this. On other variants of Linux, it is much easier to enable mod_rewrite. Ubuntu and Debian modularize the Apache configuration file (sometimes called apache2.conf, but typically called httpd.conf) and break the portions of the configuration into separate files. Usually, it’s one big file that can be edited. The key bit that Apache needs is a line that says LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so where /usr/lib/apache2/modules/mod_rewrite.so is actu-ally the path to the compiled mod_rewrite.so file.

TipFor any work on the command line that requires editing, I use Vim. You can use a text editor such as pico or nano and they may prove to be simpler. It’s a personal choice. Vim is generally considered the most powerful of the Linux command line text editors but does come with a slight learning curve. The most basic (and com-mon) commands are i (from “Command Mode”) to enter “Insert Mode,” which is the mode required to type. Esc returns the editor to “Command Mode.” To save the changes made in a file, simply type :w from “Command Mode.” You can type :q to quit Vim or can combine the save and quit routines by typing :wq. n

eAccelerator for PHPeAccelerator is a PHP opcode cache software. Opcode cache software stores PHP scripts in their compiled state. When a request comes into Apache and it hands control of execution to PHP, the PHP processor compiles scripts into a faster binary form for execution. This is handled on the fly, but the overhead of compiling code on the fly and on every page load can cause significant load on the server. To offload this extra overhead, eAccelerator caches the WordPress PHP as compiled PHP and stores it for future use, eliminating the need for repeated compilations and reducing the load on the server.



30

To install eAccelerator, you must use the phpize command that is provided with the develop-ment version of PHP. As with mod_rewrite, you can install this package via apt-get by typing apt-get install php5-dev, as demonstrated in Listing 2.4. In order to use eAccelerator, PHP must be used as an Apache module (mod_php) or as a FastCGI module.

Web ResourceTo find out more about configuring eAccelerator and to download the package, visit http://eaccelerator.net. n

LISTING 2.4

Installing apt-get from the command line

[root@wpbible ~]# apt-get install php5-devReading package lists... DoneBuilding dependency tree Reading state information... DoneThe following packages were automatically installed and are no longer required: libapparmor1 libapparmor-perl libterm-readkey-perl librpc-xml-perl

libscrollkeeper0Use ‘apt-get autoremove’ to remove them.The following extra packages will be installed: autoconf automake automake1.4 autotools-dev libltdl7-dev libtool m4 shtoolSuggested packages: autoconf2.13 autobook autoconf-archive gnu-standards autoconf-doc libtool-

doc automaken gfortran fortran95-compiler gcjThe following NEW packages will be installed: autoconf automake automake1.4 autotools-dev libltdl7-dev libtool m4 php5-

dev shtool0 upgraded, 9 newly installed, 0 to remove and 23 not upgraded.Need to get 2700kB of archives.After this operation, 10.8MB of additional disk space will be used.Do you want to continue [Y/n]? yGet:1 http://ec2-us-east-mirror.rightscale.com intrepid/main m4 1.4.11-1

[218kB]Get:2 http://ec2-us-east-mirror.rightscale.com intrepid/main autoconf

2.61-7ubuntu1 [449kB]Get:3 http://ec2-us-east-mirror.rightscale.com intrepid/main autotools-dev

20080123.1 [62.6kB]Get:4 http://ec2-us-east-mirror.rightscale.com intrepid/main automake

1:1.10.1-3 [519kB]Get:5 http://ec2-us-east-mirror.rightscale.com intrepid/main automake1.4

1:1.4-p6-13 [233kB]Get:6 http://ec2-us-east-mirror.rightscale.com intrepid/main libltdl7-dev

2.2.4-0ubuntu4 [189kB]



31

Get:7 http://ec2-us-east-mirror.rightscale.com intrepid/main libtool 2.2.4-0ubuntu4 [509kB]

Get:8 http://ec2-us-east-mirror.rightscale.com intrepid/main shtool 2.0.7-3 [159kB]

Get:9 http://ec2-us-east-mirror.rightscale.com intrepid-updates/main php5-dev 5.2.6-2ubuntu4.2 [362kB]

Fetched 2700kB in 0s (5992kB/s)Selecting previously deselected package m4.(Reading database ... 122002 files and directories currently installed.)Unpacking m4 (from .../archives/m4_1.4.11-1_i386.deb) ...Selecting previously deselected package autoconf.Unpacking autoconf (from .../autoconf_2.61-7ubuntu1_all.deb) ...Selecting previously deselected package autotools-dev.Unpacking autotools-dev (from .../autotools-dev_20080123.1_all.deb) ...Selecting previously deselected package automake.Unpacking automake (from .../automake_1%3a1.10.1-3_all.deb) ...Selecting previously deselected package automake1.4.Unpacking automake1.4 (from .../automake1.4_1%3a1.4-p6-13_all.deb) ...Selecting previously deselected package libltdl7-dev.Unpacking libltdl7-dev (from .../libltdl7-dev_2.2.4-0ubuntu4_i386.deb) ...Selecting previously deselected package libtool.Unpacking libtool (from .../libtool_2.2.4-0ubuntu4_i386.deb) ...Selecting previously deselected package shtool.Unpacking shtool (from .../shtool_2.0.7-3_all.deb) ...Selecting previously deselected package php5-dev.Unpacking php5-dev (from .../php5-dev_5.2.6-2ubuntu4.2_i386.deb) ...Processing triggers for man-db ...Processing triggers for doc-base ...Processing 2 added doc-base file(s)...Registering documents with scrollkeeper...Setting up m4 (1.4.11-1) ...Setting up autoconf (2.61-7ubuntu1) ...Setting up autotools-dev (20080123.1) ...Setting up automake (1:1.10.1-3) ...Setting up automake1.4 (1:1.4-p6-13) ...Setting up libltdl7-dev (2.2.4-0ubuntu4) ...Setting up libtool (2.2.4-0ubuntu4) ...Setting up shtool (2.0.7-3) ...Setting up php5-dev (5.2.6-2ubuntu4.2) ...

APC for PHPAPC, which stands for Alternative PHP Cache, is an alternative opcode cache to eAccelerator that doesn’t have to be compiled to work. In fact, it’s a PECL module. PECL, which stands for PHP Extension Community Library, is a sub-project of the PHP community, hosted at http://pecl.php.net, that provides a variety of community-supplied libraries for PHP. Generally, installing a PECL module is as simple as typing pecl install apc.



32

TipIt’s less likely you have PECL installed on your server than it is you would have mod_rewrite. To install PECL on Ubuntu, type apt-get install php-pear. The PEAR (PHP Extension and Application Repository) library from PHP has the required software needed to use PECL. n

Once you have installed APC, you have to add one line to your PHP configuration file. On many systems, this file is located in /etc/php.ini. On Ubuntu, you can find it in /etc/php5/apache2/php.ini. Open the file with Vim and add extension=apc.so to the end. Save and exit and restart Apache to make sure it gets loaded.

CautionAPC should not be used in conjunction with eAccelerator. Both modules are PHP opcode caches and will con-flict with each other. n

SSH2 module for PHPAs I discuss later in the book, security is not only a big deal for the developers of WordPress, but also it should be a big deal for the average user as well. Whenever possible, connect to your blog using Secure File Transfer Protocol (SFTP), which is part of Secure Shell (SSH), a network protocol that allows the exchange of data on a secure channel. SSH connections like SFTP encrypt the net-work connection between two computers. FTP, which is much more common, transmits data in plaintext and can be “sniffed” by people with network security software. It is possible for your password, or other private information being passed over the FTP connection, to be captured.

With the advent of WordPress’ autoupgrade, plugin, and theme installations, I recommend install-ing the SSH2 PECL module for PHP. When WordPress connects to itself, it still has to do so using either FTP (the default) or SSH2/SFTP. The SSH2 module is considered beta, but works pretty reli-ably and can protect you from having private information captured while upgrading your site.

In order to install this module, the libssh2 module must be compiled and installed, as shown in the following steps:

1. Type wget http://downloads.sourceforge.net/sourceforge/libssh2/libssh2-1.1.tar.gz?use_mirror=superb-west to download the latest version of libssh2. If this doesn’t work, find the direct link from http://kevin.vanzonneveld.net/techblog/tag/libssh2/ and use it instead.

2. Type tar zxvf libssh2-1.1.tar.gz to decompress the downloaded archive. Replace the filename with the version you downloaded if there is a more recent library.

3. Type cd libssh2-1.1 to change directories into the new folder.

4. Type ./configure to prepare the code for compiling.

5. Type make to begin compiling the library into a binary to install. This may take a minute.



33

6. Type make install to install libssh2 into the system. After a moment, you should see a status line that says something similar to: install ok: channel://pear.php.net/ssh2-0.11.0.

7. Install the ssh2_sftp PECL module by typing pecl install –f ssh2. The –f flag tells PECL to install the module even if there is no package in the “stable” tree. There isn’t. (The module is still considered beta.)

8. Ensure PHP knows about the new module by editing your php.ini file and adding extension=ssh2.so at the end.

9. Restart Apache by typing /etc/init.d/apache2 restart.

TipYou can check to see if the SSH2 module exists in PHP by performing a conditional if( function_exists(‘ssh2_connect’) ) check. n

FTP for PHPIf you are not able to install the SSH2 module for PHP, you should consider confirming the FTP module is installed. It is included by default with PHP 5 and with many of the prebuilt packages, including the packages from Ubuntu. If you are compiling PHP by hand, ensure that you include the –enable-ftp flag.

Installing WordPressNow that you have all the elements in place to run WordPress efficiently — PHP 4.3 or better, MySQL 4.1.2 or better, Apache or another configured Web server, and perhaps some optional caching or communications modules — it’s time to install WordPress itself.

The file size for a copy of WordPress is intentionally small. The total size of the ZIP file for WordPress 2.8 is 2.2MB. You can download the file at http://wordpress.org/latest.zip. Then unzip the file to find the wordpress/directory.

Configuring the databaseWhen you installed MySQL earlier, you didn’t create any databases. Most servers have some sort of Graphical User Interface (GUI) for doing this. Most of these GUIs use a Web-based software called phpMyAdmin for managing databases.

TipphpMyAdmin is useful for managing MySQL from a Web interface. You can download and find instructions for installing phpMyAdmin at http://phpmyadmin.net if your server provider hasn’t already provided a means of interacting with MySQL from the Web. Be careful to ensure you have protected it, however. You don’t want someone waltzing into your database and deleting your blog. n



34

If you don’t want to use phpMyAdmin, you can create a database from the command line as shown in Listing 2.5. The first command creates a new database called wordpress. The second command creates a new user called wpuser and sets the password to wppassword. It assigns the new wpuser to the wordpress database (and all tables in the wordpress database) and it gives it full access to that database, as long as the user is trying to access the server only from the same server (local-host). In some rare cases, your hostname will be different than localhost, but generally, for a single WordPress install on a single server, localhost will do.

LISTING 2.5

Creating a MySQL database, username, and password for WordPress

[root@wpbible ~]# mysql -uroot -pEnter password: <enter root password>Welcome to the MySQL monitor. Commands end with ; or \g.Your MySQL connection id is 1Server version: 5.0.67-0ubuntu6 (Ubuntu)Type ‘help;’ or ‘\h’ for help. Type ‘\c’ to clear the buffer.mysql> CREATE DATABASE wordpress;Query OK, 1 row affected (0.00 sec)mysql> GRANT ALL PRIVILEGES ON wordpress.* TO wpuser@localhost IDENTIFIED BY

‘wppassword’;Query OK, 0 rows affected (0.00 sec)<enter Ctrl-D to exit MySQL>mysql> Bye

Now that you have created a new database to use, you have to tell WordPress about it. In the newly unzipped wordpress/ folder, you’ll find a file called wp-config-sample.php. Copy this file and rename it to wp-config.php.

TipWhile any text editor should do the job in editing PHP files, I highly suggest (and recommend) that Mac users invest in Textmate from Macromates. You can download Textmate as a 30-day free trial at http://macromates.com. n

Open the wp-config.php file in a text editor (Windows users can use Notepad; Mac users can use TextEdit) and make the following changes:

NoteDo not use a word processing application like Microsoft Word because the wp-config.php file is highly commented. n



35

1. Replace define(‘DB_NAME’, ‘putyourdbnamehere’); with define(‘DB_NAME’, ‘wordpress’);.

2. Replace define(‘DB_USER’, ‘usernamehere’); with define(‘DB_USER’, ‘wpuser’);.

3. Replace define(‘DB_PASSWORD’, ‘yourpasswordhere’); with define(‘DB_PASSWORD’, ‘wppassword’);.

4. If your database host name is anything other than localhost, define(‘DB_HOST’, ‘localhost’); with define(‘DB_HOST’, ‘newdbhostname’); where newdb-hostname is the name or IP address of the database server. This is optional and likely not required.

There are some additional optional settings in here as well. Notably, it is a good idea to change the table_prefix setting. It can be anything you want and defaults to wp_. Additionally, four other set-tings are defined — AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, and NONCE_KEY — that should all be changed to unique strings or phrases. They can be anything you want, and you’ll never have to see them again. They simply help WordPress operate securely. You can auto-gener-ate random settings for these four secure keys by visiting https://api.wordpress.org/secret-key/1.1/ and copying and pasting the result on top of the exiting default settings. An example of randomly generated keys can be seen in Listing 2.6.

LISTING 2.6

An example of randomly generated secure keys from http://api.wordpress.org/secret-key/1.1/

define(‘AUTH_KEY’, ‘/~*:GN6QJE1,N^HayyNc@47?ug[)M|s)# 5(i{%W/VmvDlVhn[GU@yaN[X(uH|@x’);

define(‘SECURE_AUTH_KEY’, ‘5rXNA}tA#7DCm{=?EN-L/b2=3&7@4wPOfsJ<$]fIim=V=yIb(p]<t3k,8OA-!Uz!’);

define(‘LOGGED_IN_KEY’, ‘3$+S?|mun`&GT2]|/,).I7X4s,&HR^V,%*nZ<j<Bg4|P-*I;+_!jn7>f@|];8`Pg’);

define(‘NONCE_KEY’, ‘C-&mE>EmyLs^D_ZA,(Y+63W+GlUL)ZjS+,u-/@ubnu,z{j,/P#44gLW?Q+|$i(Y.’);

Uploading your filesOnce you have finished editing wp-config.php, it’s time to upload your files to the server. FTP (or better yet, SFTP) the contents of the wordpress/ folder to your new Web space. It will take a minute or two, but once that is complete, load your site in a browser. If everything is configured properly, you should see the first page of the installation wizard, as shown in Figure 2.2.



36

If you see a database error instead of the page shown in Figure 2.2, go back and double-check that the database credentials you supplied in wp-config.php are correct. Once you see this page, follow these steps to install WordPress:

1. Type the name of your blog in the form field labeled Blog Title. For this demonstra-tion, I’ve used “The WordPress Bible.”

2. Enter your e-mail address. This will become the general e-mail address that is used for administrative purposes on the site. It can be changed later.

FIGURE 2.2

Step 1 of the WordPress installation wizard

NoteIf you are setting up a test blog or working on a development project, you probably do not want to select the Allow my blog to appear in search engines like Google and Technorati check box. When it is selected, the search engines are notified of new content as soon as it becomes published. For this demonstration, leave it unchecked. n

3. Click the Install WordPress button.

There is only one step. The next page provides a randomly generated password for a new user called admin, as shown in Figure 2.3. This information will also be sent to the e-mail address you designated during installation.



37

FIGURE 2.3

After installation, WordPress generates a randomly generated password for the new user called admin.

With the new username and password in hand, it’s time to log in to WordPress for the first time.

Summaryl WordPress requires PHP 4.3+ and MySQL 4.1.2+. Most modern Web hosts provide a PHP

5+ build with at least MySQL 4.1. Many hosts provide PHP 5 as well.

l Apache 2 is the most common Web server in use today and is available in most Linux Web-hosting packages.

l PHP and MySQL should be optimized, particularly for blogs with more traffic.

l WordPress runs on a variety of Web server platforms, including Apache, Lighttpd, Litespeed, Nginx, and Internet Information Services (IIS).

l Beneficial system modules to include are mod_rewrite for Apache, eAccelerator, or APC for PHP, and the SSH2 and FTP libraries for PHP.

l You can interact with MySQL via phpMyAdmin or the command line.

l Use secure keys in WordPress to secure your database and cookie settings.


brazell/wordpress bible

Documents