...

...

@@ -50,7 +50,7 @@

50

50

Server.

51

51

</para>

52

52

53

-

<table>

53

+

<table xml:id="mysqli.installation.time.matrix">

54

54

<title>mysqli compile time support matrix</title>

55

55

<tgroup cols="5">

56

56

<thead>

...

...

@@ -104,82 +104,28 @@

104

104

<title>Installation on Windows Systems</title>

105

105

106

106

<para>

107

-

On Windows, PHP is most commonly installed using the binary

108

-

installer.

107

+

On Windows, <filename>php_mysqli.dll</filename> DLL must be enabled in

108

+

&php.ini;.

109

109

</para>

110

110

111

-

<section xml:id="mysqli.installation.windows.php53">

112

-

113

-

<title>PHP 5.3.0 and newer</title>

114

-

115

-

<para>

116

-

On Windows, for PHP versions 5.3 and newer, the

117

-

<literal>mysqli</literal> extension is enabled and

118

-

uses the MySQL Native Driver by default. This means you don't need to

119

-

worry about configuring access

120

-

to <filename>libmysql.dll</filename>.

121

-

</para>

122

-

123

-

</section>

124

-

125

-

<section xml:id="mysqli.installation.windows.php52">

126

-

127

-

<title>PHP 5.0, 5.1, 5.2</title>

128

-

129

-

<para>

130

-

On these old unsupported PHP versions (PHP 5.2 reached EOL on '6 Jan 2011'),

131

-

additional configuration procedures are

132

-

required to enable <literal>mysqli</literal> and specify the client

133

-

library you want it to use.

134

-

</para>

135

-

136

-

<para>

137

-

The <literal>mysqli</literal> extension is not

138

-

enabled by default, so the <filename>php_mysqli.dll</filename> DLL

139

-

must be enabled inside of &php.ini;. In order to do this you need to

140

-

find the &php.ini; file (typically located in

141

-

<filename>c:\php</filename>), and make sure you remove the comment

142

-

(semi-colon) from the start of the line

143

-

<literal>extension=php_mysqli.dll</literal>, in the section marked

144

-

<literal>[PHP_MYSQLI]</literal>.

145

-

</para>

146

-

147

-

<para>

148

-

Also, if you want to use the MySQL Client Library with

149

-

<literal>mysqli</literal>, you need to make sure PHP can access the

150

-

client library file. The MySQL Client Library is included as a file

151

-

named <filename>libmysql.dll</filename> in the Windows PHP

152

-

distribution. This file needs to be available in the Windows system's

153

-

<envar>PATH</envar> environment variable, so that it can be

154

-

successfully loaded. See the FAQ titled

155

-

"<link linkend="faq.installation.addtopath">How do I add my PHP

156

-

directory to the PATH on Windows</link>" for information on how to do

157

-

this. Copying <filename>libmysql.dll</filename> to the Windows system

158

-

directory (typically <filename>c:\Windows\system</filename>) also

159

-

works, as the system directory is by default in the system's

160

-

<envar>PATH</envar>. However, this practice is strongly discouraged.

161

-

</para>

111

+

<para>

112

+

As with enabling any PHP extension (such as

113

+

<filename>php_mysqli.dll</filename>), the PHP directive

114

+

<link linkend="ini.extension-dir">extension_dir</link> should be set

115

+

to the directory where the PHP extensions are located. See also the

116

+

<link linkend="install.windows.manual">Manual Windows Installation

117

+

Instructions</link>. An example <literal>extension_dir</literal>

118

+

value is <filename>c:\php\ext</filename>.

119

+

</para>

162

120

121

+

<note>

163

122

<para>

164

-

As with enabling any PHP extension (such as

165

-

<filename>php_mysqli.dll</filename>), the PHP directive

166

-

<link linkend="ini.extension-dir">extension_dir</link> should be set

167

-

to the directory where the PHP extensions are located. See also the

168

-

<link linkend="install.windows.manual">Manual Windows Installation

169

-

Instructions</link>. An example <literal>extension_dir</literal>

170

-

value for PHP 5 is <filename>c:\php\ext</filename>.

123

+

If when starting the web server an error similar to the following

124

+

occurs: <literal>"Unable to load dynamic library

125

+

'./php_mysqli.dll'"</literal>, this is because

126

+

<filename>php_mysqli.dll</filename> cannot be found by the system.

171

127

</para>

172

-

173

-

<note>

174

-

<para>

175

-

If when starting the web server an error similar to the following

176

-

occurs: <literal>"Unable to load dynamic library

177

-

'./php_mysqli.dll'"</literal>, this is because

178

-

<filename>php_mysqli.dll</filename> and/or

179

-

<filename>libmysql.dll</filename> cannot be found by the system.

180

-

</para>

181

-

</note>

182

-

</section>

128

+

</note>

183

129

184

130

</section>

185

131

186

132