如何使用 mysqli::character_set_name 和 mysqli::select_db 设置正确的数据库字符集？

gitbox 2025-09-03

在使用 MySQL 数据库时，确保字符集设置正确非常重要。字符集的正确设置不仅影响数据库的性能，还直接影响到数据的存储与读取，特别是在涉及多语言内容时。如果字符集设置不当，可能会导致乱码、数据丢失或者数据库查询错误。

PHP 提供了 mysqli 扩展来操作 MySQL 数据库，而 mysqli::character_set_name 和 mysqli::select_db 方法可以帮助我们确保字符集设置正确。本文将详细介绍如何使用这两个方法来配置数据库的字符集。

1. 什么是字符集？

字符集（Character Set）定义了在数据库中存储和显示的字符编码规则。常见的字符集包括 utf8、latin1、utf8mb4 等。utf8 和 utf8mb4 都支持多语言字符存储，但 utf8mb4 是更为全面的字符集，支持更多的符号与表情符号。

2. mysqli::select_db 设置数据库字符集

在使用 mysqli 连接数据库后，默认情况下，数据库连接使用的是 MySQL 数据库的默认字符集。如果想确保数据库连接使用特定字符集，可以使用 mysqli::select_db 方法。

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 创建连接</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">mysqli</span></span><span>(</span><span><span class="hljs-string">"localhost"</span></span><span>, </span><span><span class="hljs-string">"username"</span></span><span>, </span><span><span class="hljs-string">"password"</span></span><span>, </span><span><span class="hljs-string">"database_name"</span></span><span>);

</span><span><span class="hljs-comment">// 检查连接是否成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"连接失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error);
}

</span><span><span class="hljs-comment">// 设置字符集为utf8</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">set_charset</span></span><span>(</span><span><span class="hljs-string">"utf8"</span></span><span>);

</span><span><span class="hljs-comment">// 选择数据库</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">select_db</span></span><span>(</span><span><span class="hljs-string">"database_name"</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在上述代码中，set_charset 用于设置字符集，确保数据库连接采用 utf8 字符集，避免乱码问题。

3. mysqli::character_set_name 获取当前字符集

mysqli::character_set_name 方法用于获取当前连接使用的字符集。这个方法很有用，尤其是在进行调试时，你可以确认是否已经成功地切换到所需的字符集。

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 获取当前数据库连接的字符集</span></span><span>
</span><span><span class="hljs-variable">$current_charset</span></span><span> = </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">character_set_name</span></span><span>();

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"当前字符集是: "</span></span><span> . </span><span><span class="hljs-variable">$current_charset</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

如果当前字符集已经设置为 utf8，上述代码将输出：

<span><span><span class="hljs-section">当前字符集是: utf8</span></span><span>
</span></span>

4. 配置数据库字符集

除了在 PHP 中设置字符集外，你还需要确保数据库和表格的字符集设置一致。如果数据库和表格本身使用了不同的字符集，那么即使你在 PHP 中设置了字符集，也无法完全避免乱码。

4.1 在创建数据库时设置字符集

<span><span><span class="hljs-keyword">CREATE</span></span><span> DATABASE database_name </span><span><span class="hljs-type">CHARACTER</span></span><span> </span><span><span class="hljs-keyword">SET</span></span><span> utf8mb4 </span><span><span class="hljs-keyword">COLLATE</span></span><span> utf8mb4_unicode_ci;
</span></span>

4.2 在创建表时设置字符集

<span><span><span class="hljs-keyword">CREATE</span></span><span> </span><span><span class="hljs-keyword">TABLE</span></span><span> table_name (
    id </span><span><span class="hljs-type">INT</span></span><span> AUTO_INCREMENT </span><span><span class="hljs-keyword">PRIMARY</span></span><span> KEY,
    name </span><span><span class="hljs-type">VARCHAR</span></span><span>(</span><span><span class="hljs-number">255</span></span><span>) </span><span><span class="hljs-keyword">NOT</span></span><span> </span><span><span class="hljs-keyword">NULL</span></span><span>
) </span><span><span class="hljs-type">CHARACTER</span></span><span> </span><span><span class="hljs-keyword">SET</span></span><span> utf8mb4 </span><span><span class="hljs-keyword">COLLATE</span></span><span> utf8mb4_unicode_ci;
</span></span>

4.3 修改现有表的字符集

<span><span><span class="hljs-keyword">ALTER</span></span><span> </span><span><span class="hljs-keyword">TABLE</span></span><span> table_name </span><span><span class="hljs-keyword">CONVERT</span></span><span> </span><span><span class="hljs-keyword">TO</span></span><span> </span><span><span class="hljs-type">CHARACTER</span></span><span> </span><span><span class="hljs-keyword">SET</span></span><span> utf8mb4 </span><span><span class="hljs-keyword">COLLATE</span></span><span> utf8mb4_unicode_ci;
</span></span>

确保数据库和表格的字符集设置一致后，数据库的操作会更加稳定，并且可以避免由于字符集不匹配而导致的数据损坏。

5. 总结

使用 mysqli::character_set_name 和 mysqli::select_db 可以确保数据库连接使用正确的字符集，从而避免乱码或数据丢失等问题。通过设置正确的字符集，你不仅能提高数据存储的兼容性，还能确保用户从数据库中读取的数据无误。

在实际开发中，推荐始终使用 utf8mb4 字符集，因为它支持更多的字符和符号，尤其是在处理多语言内容时，可以有效避免常见的字符集错误。

相关标签:
mysqli