X-Git-Url: https://git.rapsys.eu/packbundle/blobdiff_plain/575d559e5aea5e099ba7784547b1aa359d28fb8c..9c234a4e9649893bd019463ad25ee0a9e997b316:/Twig/PackTokenParser.php diff --git a/Twig/PackTokenParser.php b/Twig/PackTokenParser.php index 8218ee1..9fffebb 100644 --- a/Twig/PackTokenParser.php +++ b/Twig/PackTokenParser.php @@ -1,109 +1,174 @@ fileLocator = $fileLocator; - $this->containerInterface = $containerInterface; - $this->prefix = $prefix; - $this->tag = $tag; - $this->output = $output; - $this->tool = $tool; + public function __construct(FileLocator $locator, PackageInterface $package, $config, $tag, $output, $filters) { + //Save locator + $this->locator = $locator; + + //Save assets package + $this->package = $package; + + //Set name + $this->name = $config['name']; + + //Set scheme + $this->scheme = $config['scheme']; + + //Set timeout + $this->timeout = $config['timeout']; + + //Set agent + $this->agent = $config['agent']; + + //Set redirect + $this->redirect = $config['redirect']; + + //Set tag + $this->tag = $tag; + + //Set output + $this->output = $output; + + //Set filters + $this->filters = $filters; } + /** + * Get the tag name + * + * @return string This tag name + */ public function getTag() { return $this->tag; } - public function parse(\Twig_Token $token) { + /** + * Parse the token + * + * @param Token token The \Twig\Token instance + * + * @return Node The PackNode + * + * @todo see if we can't add a debug mode behaviour + * + * If twig.debug or env=dev (or rapsys_pack.config.debug?) is set, it should be possible to loop on each input + * and process the captured body without applying requested filter. + * + * @todo list: + * - detect debug mode + * - retrieve fixe link from input s%@(Name)Bundle/Resources/public(/somewhere/file.ext)%/bundles/\L\1\E\2% + * - for each inputs: + * - generate a set asset_url=x + * - generate a body + */ + public function parse(Token $token) { $parser = $this->parser; $stream = $this->parser->getStream(); - $inputs = array(); - $filters = array(); - $name = 'asset_url'; + $inputs = []; + $name = $this->name; $output = $this->output; + $filters = $this->filters; $content = ''; - while (!$stream->test(\Twig_Token::BLOCK_END_TYPE)) { - if ($stream->test(\Twig_Token::STRING_TYPE)) { - // '@jquery', 'js/src/core/*', 'js/src/extra.js' + //Process the token block until end + while (!$stream->test(Token::BLOCK_END_TYPE)) { + //The files to process + if ($stream->test(Token::STRING_TYPE)) { + //'somewhere/somefile.(css,img,js)' 'somewhere/*' '@jquery' $inputs[] = $stream->next()->getValue(); - } elseif ($stream->test(\Twig_Token::NAME_TYPE, 'filter')) { - // filter='yui_js' + //The filters token + } elseif ($stream->test(Token::NAME_TYPE, 'filters')) { + //filter='yui_js' $stream->next(); - $stream->expect(\Twig_Token::OPERATOR_TYPE, '='); - $filters = array_merge($filters, array_filter(array_map('trim', explode(',', $stream->expect(\Twig_Token::STRING_TYPE)->getValue())))); - } elseif ($stream->test(\Twig_Token::NAME_TYPE, 'output')) { - // output='js/packed/*.js' OR output='js/core.js' + $stream->expect(Token::OPERATOR_TYPE, '='); + $filters = array_merge($filters, array_filter(array_map('trim', explode(',', $stream->expect(Token::STRING_TYPE)->getValue())))); + //The output token + } elseif ($stream->test(Token::NAME_TYPE, 'output')) { + //output='js/packed/*.js' OR output='js/core.js' $stream->next(); - $stream->expect(\Twig_Token::OPERATOR_TYPE, '='); - $output = $stream->expect(\Twig_Token::STRING_TYPE)->getValue(); - } elseif ($stream->test(\Twig_Token::NAME_TYPE, 'name')) { - // name='core_js' + $stream->expect(Token::OPERATOR_TYPE, '='); + $output = $stream->expect(Token::STRING_TYPE)->getValue(); + //The name token + } elseif ($stream->test(Token::NAME_TYPE, 'name')) { + //name='core_js' $stream->next(); - $stream->expect(\Twig_Token::OPERATOR_TYPE, '='); - $name = $stream->expect(\Twig_Token::STRING_TYPE)->getValue(); + $stream->expect(Token::OPERATOR_TYPE, '='); + $name = $stream->expect(Token::STRING_TYPE)->getValue(); + //Unexpected token } else { $token = $stream->getCurrent(); - throw new \Twig_Error_Syntax(sprintf('Unexpected token "%s" of value "%s"', \Twig_Token::typeToEnglish($token->getType()), $token->getValue()), $token->getLine(), $stream->getFilename()); + throw new Error(sprintf('Unexpected token "%s" of value "%s"', Token::typeToEnglish($token->getType()), $token->getValue()), $token->getLine(), $stream->getSourceContext()); } } - $stream->expect(\Twig_Token::BLOCK_END_TYPE); + //Process end block + $stream->expect(Token::BLOCK_END_TYPE); + + //Process body + $body = $this->parser->subparse([$this, 'testEndTag'], true); - $body = $this->parser->subparse(array($this, 'testEndTag'), true); + //Process end block + $stream->expect(Token::BLOCK_END_TYPE); - $stream->expect(\Twig_Token::BLOCK_END_TYPE); + //TODO: debug mode should be inserted here before the output variable is rewritten //Replace star with sha1 if (($pos = strpos($output, '*')) !== false) { - #XXX: assetic code : substr(sha1(serialize($inputs).serialize($filters).serialize($options)), 0, 7) + //XXX: assetic use substr(sha1(serialize($inputs).serialize($filters).serialize($options)), 0, 7) $output = substr($output, 0, $pos).sha1(serialize($inputs).serialize($filters)).substr($output, $pos + 1); } - //Deal with inputs + //Process inputs for($k = 0; $k < count($inputs); $k++) { //Deal with generic url if (strpos($inputs[$k], '//') === 0) { - //TODO: set this as a parameter (scheme) - $inputs[$k] = 'https:'.$inputs[$k]; + //Fix url + $inputs[$k] = $this->scheme.substr($inputs[$k], 2); //Deal with non url path } elseif (strpos($inputs[$k], '://') === false) { //Check if we have a bundle path if ($inputs[$k][0] == '@') { - if (($pos = strpos($inputs[$k], '/')) === false) { - throw new \Twig_Error_Syntax(sprintf('Invalid input path "%s"', $inputs[$k]), $token->getLine(), $stream->getFilename()); - } - //Extract prefix - #$inputs[$k] = $this->kernel->locateResource(substr($inputs[$k], 0, $pos)).substr($inputs[$k], $pos + 1); - $inputs[$k] = $this->fileLocator->locate(substr($inputs[$k], 0, $pos)).substr($inputs[$k], $pos + 1); + //Resolve it + $inputs[$k] = $this->getLocated($inputs[$k], $token->getLine(), $stream->getSourceContext()); } + //Deal with globs if (strpos($inputs[$k], '*') !== false || (($a = strpos($inputs[$k], '{')) !== false && ($b = strpos($inputs[$k], ',', $a)) !== false && strpos($inputs[$k], '}', $b) !== false)) { //Get replacement $replacement = glob($inputs[$k], GLOB_NOSORT|GLOB_BRACE); //Check that these are working files foreach($replacement as $input) { + //Check that it's a file if (!is_file($input)) { - throw new \Twig_Error_Syntax(sprintf('Input path "%s" from "%s" is not a file', $input, $inputs[$k]), $token->getLine(), $stream->getFilename()); + throw new Error(sprintf('Input path "%s" from "%s" is not a file', $input, $inputs[$k]), $token->getLine(), $stream->getSourceContext()); } } //Replace with glob path @@ -112,96 +177,227 @@ class PackTokenParser extends \Twig_TokenParser { $k += count($replacement) - 1; //Check that it's a file } elseif (!is_file($inputs[$k])) { - throw new \Twig_Error_Syntax(sprintf('Input path "%s" is not a file', $inputs[$k]), $token->getLine(), $stream->getFilename()); + throw new Error(sprintf('Input path "%s" is not a file', $inputs[$k]), $token->getLine(), $stream->getSourceContext()); } } } - //Retrieve files content - foreach($inputs as $input) { - //Set timeout - $ctx = stream_context_create( - array( - 'http' => array( - 'timeout' => 5 - ) - ) - ); - //Try to retrieve content - if (($data = file_get_contents($input, false, $ctx)) === false) { - throw new \Twig_Error_Syntax(sprintf('Unable to retrieve input path "%s"', $input), $token->getLine(), $stream->getFilename()); + //Init context + $ctx = stream_context_create( + [ + 'http' => [ + 'timeout' => $this->timeout, + 'user_agent' => $this->agent, + 'redirect' => $this->redirect, + ] + ] + ); + + //Check inputs + if (!empty($inputs)) { + //Retrieve files content + foreach($inputs as $input) { + //Try to retrieve content + if (($data = file_get_contents($input, false, $ctx)) === false) { + throw new Error(sprintf('Unable to retrieve input path "%s"', $input), $token->getLine(), $stream->getSourceContext()); + } + //Append content + $content .= $data; } - //Append content - $content .= $data; + } else { + //Trigger error about empty inputs ? + //XXX: There may be a legitimate case where we want an empty file or an error, feel free to contact the author in such case + #throw new Error('Empty inputs token', $token->getLine(), $stream->getSourceContext()); + + //Send an empty node without inputs + return new Node(); } - //Use tool - if (!empty($this->tool) && is_executable($this->tool)) { - $descriptorSpec = array( - 0 => array('pipe', 'r'), - 1 => array('pipe', 'w'), - 2 => array('pipe', 'w') - ); - if (is_resource($proc = proc_open($this->tool, $descriptorSpec, $pipes))) { - //Set stderr as non blocking - stream_set_blocking($pipes[2], 0); - //Send content to stdin - fwrite($pipes[0], $content); - //Close stdin - fclose($pipes[0]); - //Read content from stdout - if ($stdout = stream_get_contents($pipes[1])) { - $content = $stdout; - } - //Close stdout - fclose($pipes[1]); - //Read content from stderr - if ($stderr = stream_get_contents($pipes[2])) { - throw new \Twig_Error_Syntax(sprintf('Got unexpected strerr for %s: %s', $this->tool, $stderr), $token->getLine(), $stream->getFilename()); - } - //Close stderr - fclose($pipes[2]); - //Close process - if ($ret = proc_close($proc)) { - throw new \Twig_Error_Syntax(sprintf('Got unexpected non zero return code %s: %d', $this->tool, $ret), $token->getLine(), $stream->getFilename()); + //Check filters + if (!empty($filters)) { + //Apply all filters + foreach($filters as $filter) { + //Init args + $args = [$stream->getSourceContext(), $token->getLine()]; + //Check if args is available + if (!empty($filter['args'])) { + //Append args if provided + $args += $filter['args']; } + //Init reflection + $reflection = new \ReflectionClass($filter['class']); + //Set instance args + $tool = $reflection->newInstanceArgs($args); + //Process content + $content = $tool->process($content); + //Remove object + unset($tool, $reflection); } + } else { + //Trigger error about empty filters ? + //XXX: There may be a legitimate case where we want only a merged file or an error, feel free to contact the author in such case + #throw new Error('Empty filters token', $token->getLine(), $stream->getSourceContext()); } - //Create output dir on demand - if (!is_dir($parent = $dir = dirname($this->prefix.$output))) { - //XXX: set as 0777, symfony umask (0022) will reduce rights (0755) - mkdir($dir, 0777, true); + //Retrieve asset uri + //XXX: this path is the merge of services.assets.path_package.arguments[0] and rapsys_pack.output.(css,img,js) + if (($outputUrl = $this->package->getUrl($output)) === false) { + throw new Error(sprintf('Unable to get url for asset: %s', $output), $token->getLine(), $stream->getSourceContext()); + } + + //Check if we have a bundle path + if ($output[0] == '@') { + //Resolve it + $output = $this->getLocated($output, $token->getLine(), $stream->getSourceContext()); + } + + //Create output dir if not present + if (!is_dir($dir = dirname($output))) { + try { + //XXX: set as 0777, symfony umask (0022) will reduce rights (0755) + if (mkdir($dir, 0777, true) === false) { + throw new \Exception(); + } + } catch (\Exception $e) { + throw new Error(sprintf('Output directory "%s" do not exists and unable to create it', $dir), $token->getLine(), $stream->getSourceContext(), $e); + } } //Send file content - //TODO: see if atomic rotation is really necessary ? - //XXX: version management is done via rapsys_pack configuration atomic should be useless - //TODO: implement asset versionning or re-use internal functions - if (file_put_contents($this->prefix.$output.'.new', $content) === false) { - throw new \Twig_Error_Syntax(sprintf('Unable to write to: %s', $prefix.$output.'.new'), $token->getLine(), $stream->getFilename()); + //XXX: to avoid partial content in reverse cache we use atomic rotation write, unlink and move + try { + if (file_put_contents($output.'.new', $content) === false) { + throw new \Exception(); + } + } catch(\Exception $e) { + throw new Error(sprintf('Unable to write to: %s', $output.'.new'), $token->getLine(), $stream->getSourceContext(), $e); } //Remove old file - if (is_file($this->prefix.$output) && unlink($this->prefix.$output) === false) { - throw new \Twig_Error_Syntax(sprintf('Unable to unlink: %s', $prefix.$output), $token->getLine(), $stream->getFilename()); + if (is_file($output)) { + try { + if (unlink($output) === false) { + throw new \Exception(); + } + } catch (\Exception $e) { + throw new Error(sprintf('Unable to unlink: %s', $output), $token->getLine(), $stream->getSourceContext(), $e); + } } //Rename it - if (rename($this->prefix.$output.'.new', $this->prefix.$output) === false) { - throw new \Twig_Error_Syntax(sprintf('Unable to rename: %s to %s', $prefix.$output.'.new', $prefix.$output), $token->getLine(), $stream->getFilename()); + try { + if (rename($output.'.new', $output) === false) { + throw new \Exception(); + } + } catch (\Exception $e) { + throw new Error(sprintf('Unable to rename: %s to %s', $output.'.new', $output), $token->getLine(), $stream->getSourceContext(), $e); } - //Retrieve asset uri - if (($output = $this->containerInterface->get('assets.packages')->getUrl($output, 'rapsys_pack')) === false) { - throw new \Twig_Error_Syntax(sprintf('Unable to get url for asset: %s with package %s', $output, 'rapsys_pack'), $token->getLine(), $stream->getFilename()); - } + //Set name in context key + $ref = new AssignNameExpression($name, $token->getLine()); - //Send pack node - return new PackNode(array('value' => $body), array('inputs' => $inputs, 'filters' => $filters, 'name' => $name, 'output' => $output), $token->getLine(), $this->getTag()); + //Set output in context value + $value = new TextNode($outputUrl, $token->getLine()); + + //Send body with context set + return new Node([ + //This define name in twig template by prepending $context[''] = ''; + new SetNode(true, $ref, $value, $token->getLine(), $this->getTag()), + //The tag captured body + $body + ]); + } + + /** + * Test for tag end + * + * @param Token token The \Twig\Token instance + * + * @return bool + */ + public function testEndTag(Token $token) { + return $token->test(['end'.$this->getTag()]); } - public function testEndTag(\Twig_Token $token) { - return $token->test(array('end'.$this->getTag())); + /** + * Get path from bundled file + * + * @param string file The bundled file path + * @param int lineno The template line where the error occurred + * @param Source source The source context where the error occurred + * @param \Exception prev The previous exception + * + * @return string The resolved file path + */ + public function getLocated($file, int $lineno = 0, Source $source = null, \Exception $prev = null) { + /*TODO: add a @jquery magic feature ? + if ($file == '@jquery') { + #header('Content-Type: text/plain'); + #var_dump($inputs); + #exit; + return $this->config['jquery']; + }*/ + + //Check that we have a / separator between bundle name and path + if (($pos = strpos($file, '/')) === false) { + throw new Error(sprintf('Invalid path "%s"', $file), $token->getLine(), $stream->getSourceContext()); + } + + //Set bundle + $bundle = substr($file, 0, $pos); + + //Set path + $path = substr($file, $pos + 1); + + //Check for bundle suffix presence + //XXX: use "bundle templates automatic namespace" mimicked behaviour to find intended bundle and/or path + //XXX: see https://symfony.com/doc/4.3/templates.html#bundle-templates + if (strlen($bundle) < strlen('Bundle') || substr($bundle, -strlen('Bundle')) !== 'Bundle') { + //Append Bundle in an attempt to fix it's naming for locator + $bundle .= 'Bundle'; + + //Check for public resource prefix presence + if (strlen($path) < strlen('Resources/public') || substr($path, 0, strlen('Resources/public')) != 'Resources/public') { + //Prepend standard public path + $path = 'Resources/public/'.$path; + } + } + + //Resolve bundle prefix + try { + $prefix = $this->locator->locate($bundle); + //Catch bundle does not exist or is not enabled exception + } catch(\InvalidArgumentException $e) { + //Fix lowercase first bundle character + if ($bundle[1] > 'Z' || $bundle[1] < 'A') { + $bundle[1] = strtoupper($bundle[1]); + } + + //Detect double bundle suffix + if (strlen($bundle) > strlen('_bundleBundle') && substr($bundle, -strlen('_bundleBundle')) == '_bundleBundle') { + //Strip extra bundle + $bundle = substr($bundle, 0, -strlen('Bundle')); + } + + //Convert snake case in camel case + if (strpos($bundle, '_') !== false) { + //Fix every first character following a _ + while(($cur = strpos($bundle, '_')) !== false) { + $bundle = substr($bundle, 0, $cur).ucfirst(substr($bundle, $cur + 1)); + } + } + + //Resolve fixed bundle prefix + try { + $prefix = $this->locator->locate($bundle); + //Catch bundle does not exist or is not enabled exception again + } catch(\InvalidArgumentException $e) { + //Bail out as bundle or path is invalid and we have no way to know what was meant + throw new Error(sprintf('Invalid bundle name "%s" in path "%s". Maybe you meant "%s"', substr($file, 1, $pos - 1), $file, $bundle.'/'.$path), $token->getLine(), $stream->getSourceContext(), $e); + } + } + + //Return solved bundle prefix and path + return $prefix.$path; } }