WordPress 中使用 file_exists 函数检查文件是否存在的问题

本文旨在解决 WordPress 主题开发中，使用 file_exists 函数判断文件是否存在时可能遇到的问题。通过分析常见错误原因和提供正确的代码示例，帮助开发者根据文件是否存在动态加载不同的 JavaScript 文件，从而优化开发流程和提升代码的健壮性。

在 WordPress 主题开发中，经常需要根据环境（例如本地开发环境和线上生产环境）加载不同的资源文件。一个常见的需求是，如果本地存在未打包的 JavaScript 文件，则加载本地文件；否则，加载打包后的文件。file_exists 函数似乎是实现这一逻辑的理想选择，但开发者在使用过程中可能会遇到一些问题，导致判断结果不符合预期。

问题分析

问题的核心在于 file_exists 函数需要的是文件的绝对路径，而不是相对路径或者 URL。get_template_directory_uri() 函数返回的是主题目录的 URL，而 file_exists 函数无法通过 URL 来判断文件是否存在。

解决方案

正确的做法是使用 get_template_directory() 函数获取主题目录的绝对路径，然后将该路径与文件路径拼接起来，传递给 file_exists 函数。

以下是修改后的代码示例：

$file_path = get_template_directory() . '/src/javascript/pages/linksCount.js';
$file = file_exists( $file_path )
? get_template_directory_uri() . '/src/javascript/pages/linksCount.js'
: get_template_directory_uri() . '/dist/linksCount.js';
wp_register_script('links_count', $file, array(), '1.0', true);
wp_enqueue_script('links_count');

代码解释:

1. $file_path = get_template_directory() . ‘/src/javascript/pages/linksCount.js’;: 首先，使用 get_template_directory() 获取主题目录的绝对路径，并将其与相对路径 /src/javascript/pages/linksCount.js 拼接，得到文件的完整绝对路径。
2. file_exists( $file_path ): 然后，使用 file_exists() 函数检查该绝对路径对应的文件是否存在。
3. 三元运算符: 根据 file_exists() 的返回值，决定使用哪个 URL 作为脚本的源。如果文件存在，则使用本地未打包的文件的 URL；否则，使用打包后的文件的 URL。
4. wp_register_script 和 wp_enqueue_script: 最后，使用 wp_register_script 函数注册脚本，并使用 wp_enqueue_script 函数将脚本添加到页面中。

注意事项

• 路径的正确性: 确保传递给 file_exists 函数的路径是正确的绝对路径。可以使用 var_dump($file_path) 来调试路径是否正确。
• 文件权限: 确保 PHP 进程有权限读取该文件。如果文件权限不足，file_exists 函数可能会返回 false。
• 缓存: 某些服务器或 WordPress 插件可能会缓存文件是否存在的结果。如果文件刚创建或删除，可能需要清除缓存才能看到最新的结果。

总结

通过使用 get_template_directory() 函数获取主题目录的绝对路径，并将其与文件路径拼接后传递给 file_exists 函数，可以解决 WordPress 中使用 file_exists 函数判断文件是否存在的问题。 确保路径的正确性、文件权限以及注意缓存问题，可以帮助开发者更有效地管理和加载主题中的资源文件。 这种方法可以应用于其他需要根据文件是否存在动态加载资源的情况，提高代码的灵活性和可维护性。