结合umask函数与stat函数在PHP中如何检查文件权限变化？实战操作指南

gitbox 2025-07-09

一、umask()函数简介

umask()函数用于设置或获取当前进程的文件模式创建掩码（umask）。文件模式掩码决定了新创建文件的默认权限。通过设置合适的掩码，PHP程序可以确保在创建新文件时自动限制其权限。

umask()的使用

<span><span><span class="hljs-comment">// 获取当前进程的文件创建掩码</span></span><span>
</span><span><span class="hljs-variable">$current_umask</span></span><span> = </span><span><span class="hljs-title function_ invoke__">umask</span></span><span>();
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"当前的umask值是: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">decoct</span></span><span>(</span><span><span class="hljs-variable">$current_umask</span></span><span>) . </span><span><span class="hljs-string">"\n"</span></span><span>;

</span><span><span class="hljs-comment">// 设置一个新的umask</span></span><span>
</span><span><span class="hljs-title function_ invoke__">umask</span></span><span>(</span><span><span class="hljs-number">0022</span></span><span>);  </span><span><span class="hljs-comment">// 掩码值为0022，表示新文件的权限为755</span></span><span>
</span></span>

在上面的示例中，我们先获取当前的umask值，并且使用umask()函数设置一个新的掩码值。0022的含义是：新创建的文件会自动设置为755权限（即用户拥有读写执行权限，其他用户只有读取和执行权限）。

二、stat()函数简介

stat()函数用于获取指定文件的状态信息，包括文件大小、最后修改时间以及文件的权限等。它返回一个包含详细信息的数组，其中mode字段表示文件的权限模式。

stat()的基本用法

<span><span><span class="hljs-variable">$file_stat</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stat</span></span><span>(</span><span><span class="hljs-string">'example.txt'</span></span><span>);

</span><span><span class="hljs-comment">// 查看文件的权限模式</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-title function_ invoke__">decoct</span></span><span>(</span><span><span class="hljs-variable">$file_stat</span></span><span>[</span><span><span class="hljs-string">'mode'</span></span><span>]) . </span><span><span class="hljs-string">"\n"</span></span><span>;
</span></span>

stat()返回的mode是一个整数值，需要用位掩码进行解析。通过位操作，我们可以获取文件的详细权限信息。

三、结合umask()与stat()检查文件权限变化

为了更好地管理文件权限，我们可以结合使用umask()与stat()来跟踪文件权限的变化。例如，假设我们有一个文件，想要在创建文件后检查文件的实际权限，并确保它符合预期。

实践步骤：

设置合适的umask，确保新文件的权限符合我们要求。
使用stat()函数获取文件的权限。
对比stat()返回的权限值与我们预期的值，判断文件权限是否发生变化。

示例代码：

<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-title function_ invoke__">umask</span></span><span>(</span><span><span class="hljs-number">0022</span></span><span>);

</span><span><span class="hljs-comment">// 创建一个新文件</span></span><span>
</span><span><span class="hljs-variable">$file</span></span><span> = </span><span><span class="hljs-string">'example.txt'</span></span><span>;
</span><span><span class="hljs-title function_ invoke__">file_put_contents</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>, </span><span><span class="hljs-string">"This is a test file."</span></span><span>);

</span><span><span class="hljs-comment">// 获取文件状态</span></span><span>
</span><span><span class="hljs-variable">$file_stat</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stat</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>);

</span><span><span class="hljs-comment">// 获取文件权限模式</span></span><span>
</span><span><span class="hljs-variable">$file_permissions</span></span><span> = </span><span><span class="hljs-variable">$file_stat</span></span><span>[</span><span><span class="hljs-string">'mode'</span></span><span>] &amp; </span><span><span class="hljs-number">0777</span></span><span>;  </span><span><span class="hljs-comment">// 按位与操作，得到文件的权限值</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-title function_ invoke__">decoct</span></span><span>(</span><span><span class="hljs-variable">$file_permissions</span></span><span>) . </span><span><span class="hljs-string">"\n"</span></span><span>;

</span><span><span class="hljs-comment">// 判断文件权限是否符合预期</span></span><span>
</span><span><span class="hljs-variable">$expected_permissions</span></span><span> = </span><span><span class="hljs-number">0755</span></span><span>;
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$file_permissions</span></span><span> === </span><span><span class="hljs-variable">$expected_permissions</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件权限符合预期！\n"</span></span><span>;
} </span><span><span class="hljs-keyword">else</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-title function_ invoke__">decoct</span></span><span>(</span><span><span class="hljs-variable">$file_permissions</span></span><span>) . </span><span><span class="hljs-string">"\n"</span></span><span>;
}

</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

代码解析：

首先，我们通过umask(0022)设置文件权限掩码，确保新文件的权限为0755。
使用file_put_contents()函数创建一个新的文件example.txt。
然后，我们通过stat()函数获取文件的状态信息，特别是文件的权限模式（mode）。
最后，通过按位与操作(& 0777)提取文件的权限部分，并与预期权限（0755）进行对比。

输出结果：

<span><span><span class="hljs-section">文件的实际权限是: 755</span></span><span>
文件权限符合预期！
</span></span>

通过这种方式，我们可以有效地检查文件权限是否按照我们的要求设置，从而确保文件操作的安全性。