linkinfo

(PHP 4, PHP 5, PHP 7, PHP 8)

linkinfo — Ler informações sobre um link

Descrição

linkinfo(string $path): int

Obtém informação sobre um link.

Esta função é usada para verificar se um link (apontado por path) realmente existe (usando o mesmo método como a macro S_ISLNK definida em stat.h).

Parâmetros

path: Caminho para o link.

Valor Retornado

linkinfo() retorna o campo st_dev da estrutura stat do Unix C retornado pela chamada do sistema (system call) lstat. Retorna 0 ou false em caso de erro.

Exemplos

Exemplo #1 Exemplo da linkinfo()


<?php

echo linkinfo('/vmlinuz'); // 835

?>

Notas

Nota: Esta função não foi implementada na plataforma Windows.

Veja Também

symlink() - Cria um link simbólico
link() - Criando um hard link
readlink() - Retornar o alvo de um link simbólico

＋add a note

User Contributed Notes 1 note

down

rjb at robertjbrown dot com ¶

11 years ago


I expected this function to return FALSE or 0 if a symbolic link did not exist (per the documentation above), but that's not what happened. Reading the man page for the Linux kerne's stat call here: http://www.kernel.org/doc/man-pages/online/pages/man2/stat.2.html it says this:

RETURN VALUE - On success, zero is returned.  On error, -1 is returned, and errno is set appropriately.

... which is what is happening in my case. I am doing a linkinfo('/path/to/file'); on a missing symlink, and I get back a value of -1. As we know, a value of -1 is not going to evaluate to a FALSE or 0.

My point - be careful with return values for missing symlinks.

＋add a note