{"id":25257503,"url":"https://github.com/czproject/path-helper","last_synced_at":"2025-10-27T02:31:52.847Z","repository":{"id":15304993,"uuid":"18034823","full_name":"czproject/path-helper","owner":"czproject","description":"Helper class for creating relative paths, absolutizing paths,…","archived":false,"fork":false,"pushed_at":"2023-03-13T20:06:19.000Z","size":26,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-16T01:50:14.263Z","etag":null,"topics":["absolute-paths","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/czproject.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-03-23T14:17:09.000Z","updated_at":"2023-08-19T13:58:31.000Z","dependencies_parsed_at":"2022-08-25T15:22:06.766Z","dependency_job_id":null,"html_url":"https://github.com/czproject/path-helper","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czproject%2Fpath-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czproject%2Fpath-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czproject%2Fpath-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czproject%2Fpath-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/czproject","download_url":"https://codeload.github.com/czproject/path-helper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238424916,"owners_count":19470210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["absolute-paths","php"],"created_at":"2025-02-12T06:40:12.429Z","updated_at":"2025-10-27T02:31:52.842Z","avatar_url":"https://github.com/czproject.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CzProject\\PathHelper\n\n[![Build Status](https://github.com/czproject/path-helper/workflows/Build/badge.svg)](https://github.com/czproject/path-helper/actions)\n[![Downloads this Month](https://img.shields.io/packagist/dm/czproject/path-helper.svg)](https://packagist.org/packages/czproject/path-helper)\n[![Latest Stable Version](https://poser.pugx.org/czproject/path-helper/v/stable)](https://github.com/czproject/path-helper/releases)\n[![License](https://img.shields.io/badge/license-New%20BSD-blue.svg)](https://github.com/czproject/path-helper/blob/master/license.md)\n\nHelper class for creating relative paths, absolutizing paths,...\n\n\u003ca href=\"https://www.janpecha.cz/donate/\"\u003e\u003cimg src=\"https://buymecoffee.intm.org/img/donate-banner.v1.svg\" alt=\"Donate\" height=\"100\"\u003e\u003c/a\u003e\n\n\n## Installation\n\n[Download a latest package](https://github.com/czproject/path-helper/releases) or use [Composer](http://getcomposer.org/):\n\n```\ncomposer require czproject/path-helper\n```\n\nLibrary requires PHP 8.0 or later.\n\n\n## Usage\n\n\n``` php\nuse CzProject\\PathHelper;\n```\n\n### Absolutize path\n\n``` php\nPathHelper::absolutizePath($path);\n\nPathHelper::absolutizePath('path/to/my/../text/./file.txt');\n```\n\nReturns ```/path/to/text/file.txt```\n\nYou can use second parameter ```$prefix```:\n\n``` php\nPathHelper::absolutizePath('path/to/my/../text/./file.txt', NULL); // returns path/to/text/file.txt\nPathHelper::absolutizePath('path/to/my/../text/./file.txt', '/file/root/'); // returns /file/root/path/to/text/file.txt\n```\n\n\n### Creating relative path\n\n``` php\n$source = 'root/dir/docs/1.0/index.html';\n$dest = 'root/dir/imgs/image.jpg';\n\nPathHelper::createRelativePath($source, $dest);\n```\n\nReturns ```../../imgs/image.jpg```\n\n\n### Is path current?\n\n``` php\nPathHelper::isPathCurrent($path, $mask);\n\nPathHelper::isPathCurrent('dir/file.txt', 'dir/file-2.txt'); // returns FALSE\nPathHelper::isPathCurrent('dir/file.txt', 'dir/*'); // returns TRUE\nPathHelper::isPathCurrent('dir/sub/file.txt', 'dir/*'); // returns FALSE\nPathHelper::isPathCurrent('dir/sub/file.txt', 'dir/*/*'); // returns TRUE\nPathHelper::isPathCurrent('dir/sub/file.txt', 'dir/**'); // returns TRUE\n```\n\n| Mask     | Meaning\n| -------- | ------------------------------------------\n| ```**``` | means *everything*\n| ```*```  | means *everything \u003cb\u003eexcept\u003c/b\u003e ```/```*\n\n\n### Normalize path\n\nNormalizes path delimiters to `/`.\n\n``` php\nPathHelper::normalizePath($path);\n\nPathHelper::normalizePath('\\\\path\\\\to\\\\file.txt');\n```\n\nReturns `/path/to/file.txt`.\n\n\n### Helper instance\n\n``` php\n$helper = new CzProject\\PathHelper;\n$helper-\u003eabsolutizePath('/path/to/to/../file');\n$helper-\u003ecreateRelativePath('/path/to/file', '/path/to');\n$helper-\u003eisPathCurrent('/path/file', '/path/*');\n```\n\n\n------------------------------\n\nLicense: [New BSD License](license.md)\n\u003cbr\u003eAuthor: Jan Pecha, https://www.janpecha.cz/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fczproject%2Fpath-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fczproject%2Fpath-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fczproject%2Fpath-helper/lists"}