NAME
Alien::MySQL - Find or build libmysqlclient client library
SYNOPSIS
use Alien::MySQL;
use ExtUtils::MakeMaker;
WriteMakefile(
...
CONFIGURE_REQUIRES => {
'Alien::MySQL' => 0,
},
CCFLAGS => Alien::MySQL->cflags,
LIBS => Alien::MySQL->libs,
);
DESCRIPTION
This module provides the MySQL C client library (libmysqlclient). It will use the system library if available, or download and build from source if necessary.
INSTALLING DBD::mysql
For share installs, Alien::MySQL bundles mysql_config in Alien::MySQL->bin_dir. Prepend it to PATH when installing DBD::mysql:
PATH="$(perl -MAlien::MySQL -e 'print join(":", Alien::MySQL->bin_dir, $ENV{PATH})')" \
cpanm DBD::mysql
Alternatively, point DBD_MYSQL_CONFIG directly to the bundled mysql_config (on share installs):
DBD_MYSQL_CONFIG="$(perl -MAlien::MySQL -e 'print Alien::MySQL->dist_dir')/bin/mysql_config" \
cpanm DBD::mysql
Note: DBD::mysql's Makefile.PL validates --libs with Devel::CheckLib, which rejects -Wl,-rpath flags returned by Alien::MySQL->libs on share installs; using mysql_config via PATH or DBD_MYSQL_CONFIG avoids this issue.
METHODS
Inherits all methods from Alien::Base.
libs, libs_static
Overridden to add -Wl,-rpath flags on share installs so the dynamic linker can find the bundled libmysqlclient at runtime.
SEE ALSO
Alien::Base, https://dev.mysql.com/doc/c-api/en/
AUTHOR
vividsnow
LICENSE
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.