ZetCode

PHP linkinfo 函数

最后修改于 2025 年 4 月 3 日

PHP linkinfo 函数检索关于链接的信息。它返回链接的 Unix C stat 结构的 st_dev 字段。

基本定义

linkinfo 函数检查路径是否为链接并返回关于它的信息。如果链接不存在，则返回 0 或 false。

语法：linkinfo(string $path): int|false。该函数对于在操作之前验证符号链接很有用。它仅在类 Unix 系统上有效。

基本 linkinfo 示例

这展示了使用 linkinfo 检查符号链接的最简单用法。

basic_linkinfo.php 
<?php

declare(strict_types=1);

$path = "/usr/bin/php";
$linkInfo = linkinfo($path);

if ($linkInfo !== false) {
    echo "Link exists with device ID: " . $linkInfo;
} else {
    echo "Not a link or doesn't exist";
}

这检查 "/usr/bin/php" 是否为符号链接。如果是，则返回设备 ID。该函数对于常规文件或不存在的路径返回 false。

检查符号链接的有效性

我们可以使用 linkinfo 来验证符号链接是否指向有效的目标。

check_symlink.php 
<?php

declare(strict_types=1);

$symlink = "/tmp/mysymlink";

if (linkinfo($symlink) {
    echo "Symlink exists and is valid";
} else {
    echo "Symlink is broken or doesn't exist";
}

此示例检查符号链接的有效性。大于 0 的返回值表示有效的符号链接。损坏的链接返回 false。

比较链接信息

linkinfo 可以比较两个路径是否在同一文件系统设备上。

compare_links.php 
<?php

declare(strict_types=1);

$link1 = "/usr/bin/php";
$link2 = "/usr/local/bin/php";

$info1 = linkinfo($link1);
$info2 = linkinfo($link2);

if ($info1 === $info2) {
    echo "Links are on the same device";
} else {
    echo "Links are on different devices";
}

这比较两个链接的设备 ID。匹配的 ID 意味着它们在同一设备上。不同的 ID 表示不同的文件系统。

错误处理

在使用 linkinfo 时，适当的错误处理非常重要。

error_handling.php 
<?php

declare(strict_types=1);

$path = "/nonexistent/link";

try {
    $result = linkinfo($path);
    
    if ($result === false) {
        throw new RuntimeException("Invalid link or path");
    }
    
    echo "Link device ID: " . $result;
} catch (Throwable $e) {
    echo "Error: " . $e->getMessage();
}

这演示了适当的错误处理。try-catch 块捕获任何与文件系统相关的错误。我们还显式检查 false 返回值。

Windows 兼容性说明

linkinfo 在 Windows 系统上的功能有限。

windows_check.php 
<?php

declare(strict_types=1);

$path = "C:\\Windows\\System32\\cmd.exe";

if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
    echo "linkinfo has limited functionality on Windows";
} else {
    $info = linkinfo($path);
    echo "Link info: " . ($info !== false ? $info : "Not a link");
}

在 Windows 上，linkinfo 仅检查路径是否存在。它不提供设备信息。在使用此函数之前，请务必检查操作系统。

最佳实践

来源

PHP linkinfo 文档

本教程涵盖了 PHP linkinfo 函数，并提供了实际示例，展示了它在不同场景中的用法。

作者

我的名字是 Jan Bodnar，我是一位热衷于编程的程序员，拥有丰富的编程经验。自 2007 年以来，我一直在撰写编程文章。迄今为止，我撰写了 1,400 多篇文章和 8 本电子书。我拥有超过十年的编程教学经验。

列出 所有 PHP 文件系统函数。