Add a CSP header parser (CSPBuilder::fromHeader)

[fritzmg]

This introduces an additional fromHeader factory method to the CSPBuilder with which you can parse and then modify an existing Content-Security-Policy response header.

$csp = CSPBuilder::fromHeader("script-src 'self'");
$csp->addSource('style-src', 'self');

echo $csp->compile(); // script-src 'self'; style-src 'self'

This can be useful if the CSP header is defined elsewhere in the system and you want to additionally analyse or modify said header.

[paragonie-security]

Thanks! This is a wonderful addition to this library.

[fritzmg]

Nice :). @paragonie-security will you tag this as 2.10.0?

[fritzmg]

@paragonie-security any chance of this getting tagged as a new release?