PHPackages                             open-actu/url - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. open-actu/url

ActiveSymfony-bundle

open-actu/url
=============

Url sanitization, validation and storage

020[1 issues](https://github.com/OpenActu/UrlBundle/issues)PHP

Since Mar 31Pushed 9y agoCompare

[ Source](https://github.com/OpenActu/UrlBundle)[ Packagist](https://packagist.org/packages/open-actu/url)[ RSS](/packages/open-actu-url/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Summary
=======

[](#summary)

This Bundle offers a powerfull toolkit who serve to sanitize, validate and submit url.

As explained below, the prior objective is to give a very consistent crawling system (a little more than a "parse\_url" and "curl exec" ...).

Symfony installation
====================

[](#symfony-installation)

You can easily install in your Symfony Standard Distribution with composer:

```
composer require open-actu/url dev-master

```

Then add the bundle to your AppKernel.

```
// app/AppKernel.php
$bundles = array(
    // ..
    new OpenActu\UrlBundle\OpenActuUrlBundle(),
    // ..
);

```

Now you need to add the config url in the main config file 'app/config/config.yml'

```
open_actu_url:
    url:
        # ==========================
        # schemes requirement
        # ==========================
        # provides lines for the management of valid URL schemes
        # ==========================
        schemes: [ "http", "https","file" ]
        # ==========================
        # scheme default
        # ==========================
        # this scheme will be used when no scheme is indicated
        # ==========================
        scheme_default: "http"
        # ==========================
        # level exception management
        # ==========================
        # two modes are availabled : "INFO" and "ERROR"
        # - INFO : this mode store exception in a exception bag. The exceptions can be retrieved with
        #          method "getExceptions" on service manager
        # - ERROR: this mode provide an UrlException at the first error detected
        # ==========================
        level_exception: "INFO"
        # ==========================
        # defaults ports requirements
        # ==========================
        # (OPTIONAL) Configuration area to manage the port use.
        # three modes are availabled: "normal", "forced" and "none"
        # - normal (RECOMMANDED): If the port is the standard port used with the current scheme, the port will
        #                          be omitted.
        # - forced		: force the port information. If port is not given, the port takes the default port
        #                          relative to the current scheme
        # - none		: use port only if the information is done
        port:
            defaults:
                - { scheme: http,port: 80 }
                - { scheme: https,port: 443 }
            mode: "forced"
        # ===========================
        # protocol configuration
        # ===========================
        # (OPTIONAL) Configuration to manage the remote request sending
        # - get (DEFAULT) 	: send request as GET query
        # - post		: send request as POST query
        protocol:
            method: "get"
            timeout: 10
        # ==========================
        # response management
        # ==========================
        response:
        # purge the delay requirement according to the unit choosen
        # to process it, you need to add a cron with the calling of
        # the command "open-actu:response:purge"
        # the unit accepted are second, minute, hour, day or month
            purge:
                delay: 1
                unit: hour

```

Finally, you must add a mapping type in the doctrine area (allways in 'app/config/config.yml')

```
doctrine:
    dbal:
        ...
        mapping_types:
            enum: string

```

Congratulation, you can use this bundle !

Use case
========

[](#use-case)

Here is done the basic example use we can have with it. This works only if you check the required minimal configuration (entity creating ...) as explained in the next chapters.

```
  ...
  use MyBundle\MyLink;
  ...
  $usm= $this->container->get('open-actu.url_storage.manager');
  $um = $this->container->get('open-actu.url.manager');

  // Configuration settings
  $um->changePortMode('normal');

  /**
   * sanitize area - first step to work
   */
  $link = $um->sanitize(MyLink::class,"http://www.google.fr/");

  # we push (this is not obligatory)
  $usm->push($link);

  if(null !== $link && !$um->hasErrors())
  {
 	/**
	 * now we can send request and receive response
	 */
	$um->send($link);

	/**
	 * we said that the link can not be updated
	 */
	$link->setAcceptUpdate(true);

	/**
	 * we can store the object in database
	 */
	$usm->push($link);

  }
```

Features
========

[](#features)

The source of the documentation is stored in the `Resources/doc/` folder :

[sanitize url](https://github.com/OpenActu/UrlBundle/blob/master/Resources/doc/url_sanitization.rst)

[working with url entity](https://github.com/OpenActu/UrlBundle/blob/master/Resources/doc/work_with_url_entity.rst)

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/4a9583c7a1bff2fa0c1cb9048760b1a7d8c676bc9424ccf161ceaf946b56f746?d=identicon)[OpenActu](/maintainers/OpenActu)

---

Top Contributors

[![OpenActu](https://avatars.githubusercontent.com/u/26091846?v=4)](https://github.com/OpenActu "OpenActu (95 commits)")

### Embed Badge

![Health badge](/badges/open-actu-url/health.svg)

```
[![Health](https://phpackages.com/badges/open-actu-url/health.svg)](https://phpackages.com/packages/open-actu-url)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)