vendor/sabre/dav/lib/DAV/INodeByPath.php


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

<?php

declare(strict_types=1);

namespace Sabre\DAV;

/**
 * INodeByPath.
 *
 * This interface adds a tiny bit of functionality to collections.
 *
 * Getting a node that is deep in the tree normally requires going trough each parent node
 * which can cause a significant performance overhead.
 *
 * Implementing this interface allows solving this overhead by directly jumping to the target node.
 *
 * @copyright Copyright (C) Robin Appelman (https://icewind.nl/)
 * @author Robin Appelman (https://icewind.nl/)
 * @license http://sabre.io/license/ Modified BSD License
 */
interface INodeByPath
{
    /**
     * Returns the INode object for the requested path.
     *
     * In case where this collection can not retrieve the requested node
     * but also can not determine that the node does not exists,
     * null should be returned to signal that the caller should fallback
     * to walking the directory tree.
     *
     * @param string $path
     *
     * @return INode|null
     */
    public function getNodeForPath($path);
}