# Integrate Phalcon with Medianova CDN

Phalcon is an open-source PHP framework designed for speed and efficiency.\
Unlike traditional PHP frameworks, Phalcon is implemented as a C extension, providing exceptional execution performance with MVC architecture support.

This guide explains multiple integration methods for connecting Phalcon-based applications with **Medianova CDN** to deliver static files (CSS, JS, images) from the nearest CDN edge.

{% hint style="info" %}
Before integration, back up your project files and database.
{% endhint %}

### Prerequisites

* A configured **CDN Resource**
* Access to the Phalcon project source code
* PHP 7.4 or later (recommended)

### Integration Methods

{% stepper %}
{% step %}

### Use `setStaticBaseUri`

The simplest way to integrate your Phalcon application with Medianova CDN is by defining a static base URI.\
This approach ensures that dynamic content stays on your origin, while static files (CSS, JS, images) are delivered via CDN.

```php
<?php

$url = new Phalcon\Mvc\Url();

// Dynamic URIs remain on your origin server
$url->setBaseUri('/');

// Static resources go through Medianova CDN
$url->setStaticBaseUri('https://<CDN_ZONE_URL>/');

```

{% hint style="info" %}
Replace `<CDN_Resource_URL>` with your actual CDN Resource URL (for example: `https://example.mncdn.com/`).
{% endhint %}
{% endstep %}

{% step %}

### Use Asset Collections with Conditional CDN Prefix

For more granular control, you can configure your asset collections to automatically switch between development and production environments.

```php
<?php

$css = $this->assets->collection('header');
$scripts = $this->assets->collection('footer');

if ($config->environment == 'development') {
    $css->setPrefix('/');
    $scripts->setPrefix('/');
} else {
    $cdnURL = 'https://<CDN_ZONE_URL>/';
    $css->setPrefix($cdnURL);
    $scripts->setPrefix($cdnURL);
}

$css->addCss('css/bootstrap.min.css')
    ->addCss('css/custom.css');

$scripts->addJs('js/jquery.js')
    ->addJs('js/bootstrap.min.js');

```

{% hint style="info" %}
This method allows you to automatically use local assets in development and CDN-prefixed URLs in production.
{% endhint %}
{% endstep %}

{% step %}

### Direct CDN Path in Asset Definition

You can also directly define CDN-prefixed URLs when adding assets to your project.

```php
<?php
$cdnURL = 'https://<CDN_ZONE_URL>/';
$this->assets
     ->addCss($cdnURL . 'css/custom.css', false);
```

{% endstep %}

{% step %}

### Verify CDN Integration

After applying one of the methods above:

1. Deploy your changes to the web server.
2. Open your website in a browser.
3. View the HTML source (`Ctrl + U`) and confirm that static file URLs begin with your **CDN Resource** domain.

{% hint style="info" %}
Example:\
`https://example.mncdn.com/css/bootstrap.min.css`
{% endhint %}
{% endstep %}
{% endstepper %}

### Troubleshooting

| Problem                                     | Cause                                                     | Solution                                                                                                                           |
| ------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Assets are still served from the origin** | The CDN prefix is not applied in code.                    | Verify that `setStaticBaseUri()` or `$css->setPrefix()` includes your correct CDN Resource URL.                                    |
| **Invalid asset paths**                     | The CDN prefix or local directory structure is incorrect. | Check the path structure inside your assets directory and ensure the CDN path matches the file hierarchy.                          |
| **SSL-related warnings**                    | HTTPS not enabled on CDN resource.                        | Enable **Shared SSL** or **Custom SSL** in the [**Medianova Control Panel**](https://cloud.medianova.com) before using HTTPS URLs. |