[基础教程]functions.php文件的注意事项

ronpris
ronpris
ronpris
253
文章
1
评论
2020年4月29日14:39:59 评论 86 1885字阅读6分17秒

很多WordPress文章中都提到“将xx代码添加到主题的functions.php文件”,但总有些新手朋友总是反馈说:如何添加?添加后出错?添加后网站就不能访问啦……所以今天主要说一说编辑 functions.php 文件应该注意哪些问题。

functions.php 作用

functions.php 是 WordPress 预留的功能函数文件,专门用于添加各种自定义函数代码。现在的WordPress主题的功能越来越强大了,一般都自带了 functions.php 这个文件(通常在主题根目录)。
php中的注释
注释,就是专门用来对代码进行补充说明的文本,一般分为单行注释和多行注释,单行注释使用两个斜杠 // ,多行注释使用 /* */,示例:

<?php
/**
* 这是多行注释
* 注释2行以上内容
*/
function hello_world() {
// 单行注释
// 再注释一行
echo "<p>Hello World!</p>";
}
?>

php代码应该添加到 <?php 和 ?> 之间
打开 functions.php 文件,你会发现,文件开头一般都是 <?php ,说明这个文件是遵循php代码规范的,你需要将函数代码添加到它的里面,比如:

<?php
//开始php语法
function hello_world() {
echo "<p>Hello World!</p>";
}

//结束php语法
?>

避免 <?php 和 ?> 多重嵌套
在 <?php 和 ?> 之间,不要再添加 <?php 和 ?>,如下面的例子就是错误的:

<?php
//开始php语法

<?php //错误:嵌套啦
function hello_world() {
echo "<p>Hello World!</p>";
}
?>

可以看到,第一个 <?php 没有结束,又嵌套了一个 <?php ,这样的后果就是导致部分 php 代码失效,严重的可能会导致网站崩溃。
不要在 <?php 和 ?> 之间直接添加其他语种代码
<?php 和 ?> 之间的代码应该符合php语言规范,你不可以直接在他们之间直接添加其他语种代码,比如以下几种错误类型:

<?php
//错误1:直接添加文本
Hello World!
//错误2:直接添加html代码
<div><p>Hello World!</p></div>
//错误3:直接添加js代码
<script type="text/javascript">
$(document).ready(function() {
$("a.anchorLink").anchorAnimate()
});
</script>
//错误4:直接添加css代码
<style type="text/css" media="screen">
.textComment{
display: inline;
}
</style>
?>

可能有人会说,为什么看到有些人可以添加html代码?比如下面代码的第 5 行:

<?php
function hello_world() {
echo "<p>Hello World!</p>";
?>
<div><p>Hello World!</p></div>
<?php
}
?>

其实这是php和html混排,Html代码并没有直接添加在 <?php 和 ?> 之间,你可以看到 第 4 行结束php语法,第 6 行重新开始 php语法,这种写法是合法的。

注意字符转义
网络上很多代码由于没有使用代码高亮插件,可能会导致代码中的某些字符发生转义,或其他错误。比如:
半角符号变成全角符号:引号、逗号、句号、冒号、括号、分号等
常见的转义:< 变成 &lt; ,> 变成 &gt; ,& 变成 &amp; 等

注意php文件的编码
WordPress 是使用 utf-8 格式编码的php程序,utf-8编码又分为 含BOM 和 无BOM 两种,由于我们很可能在 php 文件中添加了中文,所以建议保存 functions.php 等php文件为 Utf-8 无 BOM 格式。否则,很可能会出现 网站空白、布局错乱、出现异常文字 等问题。

使用专业的代码编辑工具
强烈建议大家使用专业一点的代码编辑工具,比如 Notepad++、Sublime Text、EditPlus、DreamWeaver等,使用这类工具的好处:支持代码高亮、代码纠错提示、快捷插入代码片段、支持选择编码类型等等。

特别提示:不要使用微软自带的 txt记事本编辑器 来编辑 php 文件!!很可能会导致代码错误、编码错误等问题!!很多 FTP软件默认也是调用 txt记事本编辑器的 ,需要注意。最后,建议大家学习一下php编程入门,至少简单了解一下基本的语句用法,比如 if、echo 等。

提灯小生提示:修改WordPress任何文件之前,一定要做好备份,这将避免99%的未知类问题的发生。

继续阅读
[基础教程]Mysql单表查询优先级实例讲解 原创推荐

[基础教程]Mysql单表查询优先级实例讲解

这篇文章主要介绍了MySQL单表查询操作,结合实例形式详细分析了mysql单表查询的语法、约束、分组、聚合、过滤、排序等相关原理、操作技巧与注意事项,需要的朋友可以参考下 本文实例讲述了MySQL单表...
[基础教程]Linux系统常用文件管理命令 原创推荐

[基础教程]Linux系统常用文件管理命令

这篇文章主要介绍了linux文件管理命令,结合实例形式分析Linux文件管理的显示、查看、统计等相关操作命令使用技巧,需要的朋友可以参考下 本文实例讲述了linux文件管理命令。分享给大家供大家参考,...