{"id":14990062,"url":"https://github.com/piedweb/curl","last_synced_at":"2025-04-12T02:04:07.689Z","repository":{"id":33969523,"uuid":"164476067","full_name":"PiedWeb/curl","owner":"PiedWeb","description":"[READ-ONLY]  PHP curl OOP Wrapper and a bit more","archived":false,"fork":false,"pushed_at":"2025-04-04T06:36:08.000Z","size":121,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T02:04:02.211Z","etag":null,"topics":["api","curl","http","http-client","php"],"latest_commit_sha":null,"homepage":"https://dev.piedweb.com/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PiedWeb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-07T18:48:26.000Z","updated_at":"2025-03-13T15:03:35.000Z","dependencies_parsed_at":"2023-12-29T21:52:47.573Z","dependency_job_id":"8a03f843-9b68-496a-a693-ee7924b597e4","html_url":"https://github.com/PiedWeb/curl","commit_stats":{"total_commits":73,"total_committers":4,"mean_commits":18.25,"dds":0.5616438356164384,"last_synced_commit":"6a653a5efedf13bdf5c9e5a23ed100f2518a74df"},"previous_names":[],"tags_count":93,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2Fcurl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2Fcurl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2Fcurl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2Fcurl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PiedWeb","download_url":"https://codeload.github.com/PiedWeb/curl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248505862,"owners_count":21115354,"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":["api","curl","http","http-client","php"],"created_at":"2024-09-24T14:19:24.157Z","updated_at":"2025-04-12T02:04:07.668Z","avatar_url":"https://github.com/PiedWeb.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Curl OOP Wrapper\n\n[![Latest Version](https://img.shields.io/github/tag/PiedWeb/PiedWeb.svg?style=flat\u0026label=release)](https://github.com/PiedWeb/PiedWeb/tags)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE)\n[![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/PiedWeb/PiedWeb/run-tests.yml?branch=main)](https://github.com/PiedWeb/PiedWeb/actions)\n[![Quality Score](https://img.shields.io/scrutinizer/g/PiedWeb/PiedWeb.svg?style=flat)](https://scrutinizer-ci.com/g/PiedWeb/PiedWeb)\n[![Code Coverage](https://codecov.io/gh/PiedWeb/PiedWeb/branch/main/graph/badge.svg)](https://codecov.io/gh/PiedWeb/PiedWeb/branch/main)\n[![Type Coverage](https://shepherd.dev/github/PiedWeb/PiedWeb/coverage.svg)](https://shepherd.dev/github/PiedWeb/PiedWeb)\n[![Total Downloads](https://img.shields.io/packagist/dt/piedweb/curl.svg?style=flat)](https://packagist.org/packages/piedweb/curl)\n\nSimple PHP Curl OOP wrapper for efficient request.\n\nFor a more complex or abstracted curl wrapper, use [Guzzle](https://guzzle.readthedocs.io/en/latest/).\n\n## Install\n\nVia [Packagist](https://img.shields.io/packagist/dt/piedweb/curl.svg?style=flat)\n\n```bash\n$ composer require piedweb/curl\n```\n\n## Usage\n\nQuick Example :\n\n```php\n$url = 'https://piedweb.com';\n$request = new \\PiedWeb\\Curl\\ExtendedClient($url);\n$request\n    -\u003esetDefaultSpeedOptions(true)\n    -\u003esetDownloadOnlyIf('PiedWeb\\Curl\\Helper::checkContentType') // 'PiedWeb\\Curl\\Helper::checkStatusCode'\n    -\u003esetDesktopUserAgent()\n;\n$result = $request-\u003erequest();\nif ($result instanceof \\PiedWeb\\Curl\\Response) {\n    $content = $this-\u003egetContent();\n}\n```\n\nStatic Wrapper Methods :\n\n```php\nuse PiedWeb\\Curl\\StaticClient as Client;\n\nClient::request($url); // @return ?string\nClient::get(); // @return PiedWeb\\Curl\\ExtendedClient\nClient::reset()\n\n```\n\nAll Other Methods :\n\n```php\n\n$r = new PiedWeb\\Curl\\ExtendedClient(?string $url);\n$r\n    -\u003esetOpt(CURLOPT_*, mixed 'value')\n\n\t// Preselect Options to avoid eternity wait\n    -\u003esetDefaultGetOptions($connectTimeOut = 5, $timeOut = 10, $dnsCacheTimeOut = 600, $followLocation = true, $maxRedirs = 5)\n    -\u003esetDefaultSpeedOptions() // no header except if setted, 1 redir max, no ssl check\n    -\u003esetNoFollowRedirection()\n    -\u003esetReturnOnlyHeader()\n    -\u003esetCookie(string $cookie)\n    -\u003esetReferer(string $url)\n    -\u003efakeBrowserHeader(bool $doIt = true)\n    -\u003esetUserAgent(string $ua)\n    -\u003esetDesktopUserAgent()\n    -\u003esetMobileUserAgent()\n    -\u003esetLessJsUserAgent()\n        -\u003egetUserAgent() // @return string\n\n    -\u003esetDownloadOnlyIf(callable $func) // @param $ContentType can be a String or an Array\n    -\u003esetMaximumResponseSize(int $tooBig = 200000) // @defaut 2Mo\n    -\u003esetDownloadOnly($range = '0-500')\n\n    -\u003esetPost(array $post)\n\n    -\u003esetEncodingGzip()\n\n    -\u003esetProxy(string '[scheme]proxy-host:port[:username:passwrd]') // Scheme, username and passwrd are facultatives. Default Scheme is http://\n\n    -\u003esetTarget($url)\n        -\u003egetTarget()\n\n    $r-\u003erequest(); // @return true if request succeed else false (see getError)\n\n$response = $r-\u003egetResponse(); // @return PiedWeb\\Curl\\Response or int corresponding to the curl error\n\n$response-\u003egetUrl(); // @return string\n$response-\u003egetContentType(); // @return string\n$response-\u003egetContent(); // @return string\n$response-\u003egetHeaders($returnArray = true); // @return array Response Header (or in a string if $returnArray is set to false)\n$response-\u003egetCookies(); // @return string\n$response-\u003egetUrl(); // @return string\n\n$response-\u003egetError(); // Equivalent to curl function curl_errno\n$response-\u003egetErrorMessage(); // .. curl_error\n\n\nuse PiedWeb\\Curl\\ResponseFromCache;\n\n$response = new ResponseFromCache(  // same methods than Response except getRequest return null\n    string $filePathOrContent,\n    ?string $url = null,\n    array $info = [],\n    $headers = PHP_EOL.PHP_EOL\n);\n\n```\n\n## Contributing\n\nPlease see [contributing](https://dev.piedweb.com/contributing)\n\n## Credits\n\n- [PiedWeb](https://piedweb.com)\n- [All Contributors](https://github.com/PiedWeb/:package_skake/graphs/contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE) for more information.\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://dev.piedweb.com\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/PiedWeb/piedweb-devoluix-theme/master/src/img/logo_title.png\" width=\"200\" height=\"200\" alt=\"Open Source Package\" /\u003e\n\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiedweb%2Fcurl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiedweb%2Fcurl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiedweb%2Fcurl/lists"}