MySQL Perl support requires that you have installed MySQL client programming support (libraries and header files). Most installation methods install the necessary files. If you install MySQL from RPM files on Linux, be sure to install the developer RPM as well. The client programs are in the client RPM, but client programming support is in the developer RPM.
The files you need for Perl support can be obtained from the CPAN (Comprehensive Perl Archive Network) at
The easiest way to install Perl modules on Unix is to use the
CPAN module. For
perl -MCPAN -e shellcpan>
DBD::mysql installation runs a number of tests. These tests attempt to connect
to the local MySQL server using the default user name and password. (The default user name is your login name on
ODBC on Windows. The default password is "no password.") If you cannot connect to the server with those values (for
example, if your account has a password), the tests fail. You can use
DBD::mysql to ignore the failed tests.
DBI requires the
Data::Dumper module. It may be
installed; if not, you should install it before installing
It is also possible to download the module distributions in the form of compressed tar archives and build the modules manually. For example, to unpack and build a DBI distribution, use a procedure such as this:
Unpack the distribution into the current directory:
gunzip < DBI-
VERSION.tar.gz | tar xvf -
This command creates a directory named
Change location into the top-level directory of the unpacked distribution:
Build the distribution and compile everything:
The make test command is important because it verifies that the
module is working. Note that when you run that command during the
installation to exercise the interface code, the MySQL server must be running or the test fails.
It is a good idea to rebuild and reinstall the
DBD::mysql distribution whenever you
install a new release of MySQL. This ensures that the latest versions of the MySQL client libraries are
If you do not have access rights to install Perl modules in the system directory or if you want to install local
Perl modules, the following reference may be useful:
Look under the heading "Installing New Modules that Require Locally Installed Modules."